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Introducing ProtoGen+. Visual tools with the most awesome 
workbench ever created for Windows development. 


Discover the ease and 
productivity ot visual 
development! 


Visually 

develop 

screens 


he future has arrived—a complete 
point-and-click, WYSIWYG 
workbench that lets you create 
dazzling applications without 
writing a line of code. 

Paint your 
screens. Design 
a menu and link 
screens togeth¬ 
er. Test the flow 
in a live environ¬ 
ment. and gen¬ 
erate code for 
ANSI C, C++ 
for OWL or MFC 
or Pascal with 
objects. It’s that 
easy. 

And this 

open! ProtoGen+ 
will work with 

_ your database, 

compiler, 

libraries and extensions. Powerful 
add-on features, like SQLView offer 


Create a menu 
and connect 
screens & dialogs 


Test the applica¬ 
tion's screen (low In 
a live environment 


Instantly generate 
source code in 
Pascal, C or C++ 
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Bring your applications to life using the latest 
visual design tools! 


workbench access to multiple 
databases to develop client/server and 
xBase applications. Snap-in compo¬ 
nents make ProtoGen+ open to future 
development technologies—whatever 
they may be. 

ProtoGen+ is easy to learn, 
speeds your development cycle and 
protects your investment by generat¬ 
ing C,C++ and Pascal. We guarantee 
you'll 
prototype 
and generate 
exciting 
applications 
faster than 


The most powerful, open set of 
Visual Development Tools ever! 
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Point-and-click to paint 
screens with bitmaps, 
icons, tables, data valida¬ 
tion, custom colors, fonts, 
3D effects, visual tool¬ 
bars, status lines, balloon 
help, MDI and more! 


you ever 

thought 

possible! 
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flie Visual Development Edge™ 

All products named are trademarks of their 
respective companies. ©1993 ProtoView Development 


Build win¬ 
dows, forms, 
dialog boxes, 
tool bars 

Output C. 
C++ and 
Pascal with 
Objects 

Create new 
designers! 
Source 
included 


Dialog 

Menu 

Editor 

Designer 

Code 

ProtoView 

Gener¬ 

Screen 

ator 

Manager 

Custom 

Win- 

Visual 

Control 

Designer 

Library 


Quickly 
create a 
menu using 
templates 

Data valida¬ 
tion, 3-D 
effects, MDI 
and more 

Rich library 
of visual 
control 
objects 




License our technology to 
create new code generators 


Fasten your seatbelt 
for ProtoGen+! 


Only 


(list price 
$395) 


$199 

1 - 800 - 231-8588 

Ask for Ext. 60 
In NJ, call (908) 329-8588 
ProtoGen+'s SQLView access to multiple 
databases is available at an additional price; 
ask about it when you call. 
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Declare Your DBMS Independence 

Hivi ! Q + E Database Library 2 



Use Q+E Database Library to 
develop powerful client server 
applications that work with 
all major databases. 

Q+E Database Library 
eliminates the complex details 
of accessing and manipulating 
data from multiple data sources, 


Code Once 

Put world-class applications in 
your user's hands quickly by 
writing code once to access all 
major databases. In record 
time, you can build an 
application that accesses 
Oracle, dBASE, SQL Server, 
Paradox, DB2, or any other 
database. You can even prototype 
and test with one DBMS and 
deliver against another. 


Odbc And Idapi 

Q+E Database Library's high- 
level API allows you to create 
ODBC-compliant applications 
in a fraction of the time it 
takes with the ODBC SDK. 
Future releases of 
Q+E Database Library will 
automatically make 
these same applications 
IDAPI-compatible. Why risk 
making the wrong choice 
between competing standards? 
Use Q+E Database Library 
and instantly get support for 
both ODBC and IDAPI. 


Proven Technology 

Employ the same technology 
used by Microsoft, Lotus, 
WordPerfect, Computer 
Associates, Borland, and IBM 
to create their DBMS- 
independent applications. 
Don't take chances. Use the 
industry's leading market- 
proven technology. 

CAi* 

800 - 876-3101 

Ouo* 

Order Q+E Database Library 
today and discover the best 
way to develop DBMS- 
independent client server 
applications. If after 30 days 
you don't love it, return it for 
a no-hassles refund. 


Q+E Database Library 2 applications can be 
distributed royalty free. Distribution licenses are 
required for distribution of the Q+E database drivers. 
*Q+E Database Li bran,’ Version 2 is available for 
Windows today and will support OS/2, Macintosh, 
Windows NT, and UNIX by the first quarter of 1994. 


High-level API Eliminotes the complex details 

of accessing and manipulating 
data from multiple data 
sources _ 

Includes Over 20 Drivers Btrieve, DB2j, DB2/2, 
dBASE, Excel, 

HP AtLBASE /SOL 
HP IMAGE/SQL, INFORMIX, 
INGRES, Microsoft SQL Server, 
NetWare SQL, Orade, 

Paradox, PROGRESS, 

SQL Base, $Ql/400t, 
SQL/DSt, 

Sybase SQL Server, 

Teradatot, XDB & Text 
(] requites gateway) 


ODBC Compliance 

Enables ODBC application 
development 

Cross Platform 

Windows, Macintosh, UNIX, 
OS/2, Windows NT 

Q+E Query Builder 

Allows users of your 
application to create complex 
SQL statements without 
knowinq SQL 

Conversion Routines 

Convetsion between different 
DBMS data types 

Data Dictionary 

Common data dictionary 
functions for oil DBMS 

Find Functions 

Automates look-ups 

QBE 

Easily create Query by 
Example applications 


All Development Tools 

Don't throw away your 
existing development 
environment just to gain 
DBMS independence. 

Q+E Database Library works 
with the tools you already 
have. It works with the macro, 
script, or programming 
language of any application or 
development tool, including 
C, COBOL, Pascal and 
Visual Basic. 


Cross Platform 

Get consistent DBMS access 
across all major operating 
systems*. With Q+E Database 
Library, your ODBC-compliant 
applications will run on all 
platforms--even those where 
ODBC is not yet supported. 


Get The Job Done 

Q+E Database Library comes 
with a complete set of database 
tools to help you get your job 
done faster. 


5540 Centerview Drive • Suite 324 
Raleigh, N.C. 27606 » 919 859-2220 
Fax 919 859-9334 • 800 876-3101 
In Europe: 

P.0. Box 84.034 • 3009 CA • Rotterdam, The Netherlands 
(31) 10 2202 022 * Fax (31) 10 4563 348 


© 1993 Q+E Software. Q+E is a registered trademark of Q+E Software. 
Other brands and product names are the property of their respective owners. 
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Multimedia 


Windows Multimedia, Part 1: Bitmap Special Effects. 31 

Multimedia effects can add pizzazz to your existing Windows application. One way to start 
adding multimedia to your program is to give your bitmaps motion. Rather than displaying 
bitmaps in one fell swoop with BitBItQ, you can paint them with eye-catching algorithms that 
imply movement. This article supplies reusable code for two popular special effects: the 
crush and the diagonal display. 

Charles Mirho 

Features 


Dynamic-Link Device Drivers for DOS. 19 

DOS device drivers give your DOS program a degree of independence, but the user has to 
load them at boot time, where they take up precious conventional memory even when they 
are not being used. Thomas shows you how to create “dynalink device drivers" that provide 
device independence while offering DLL-style runtime flexibility. 

Thomas W. Nelson 

.mrb and .shg File Formats. 37 

Microsoft’s WinHelp introduced some proprietary bitmap file formats for handling hotspots 
and for coping with different display resolutions. Without detailed information on these new 
file formats, programmers have to depend on Microsoft for tools to edit and access the 
information the files contain. This article presents the first public documentation for the file 
formats generated by Microsoft’s hotspot editor and multiple-resolution bitmap compiler. 

Pete Davis 

Testing the Windows DOS Extender. 47 

Windows is, in part, a DOS extender. Every time your Windows application perofrms an INT 
21 h (due to file I/O, for example), Windows has to copy the request to real-mode memory, 
get DOS to execute it, then move any resulting data back up to extended memory. But how 
complete a DOS extender is it? This article explores the answer to that question and 
provides a handy table that compares the DOS-extended environments of DOS, Windows 
3.1, Windows NT, a 3.1 DOS box, and an NT DOS box. 

Walter Oney 


Product Spotlight 

Instant-C. 73 

Instant-C is an interactive tool for DOS programmers that provides an integrated, interactive 
environment for creating and debugging code. Unlike a traditional compiler, though, 

Instant-C provides incremental compilation — you can even change code while you are 
debugging. This article looks at the latest version of this distinctive tool for C programmers. 
Jeffrey L. Armbruster 


Columns 


Windows Questions and Answers. 7 

Neil Sandlin provides a technique for breaking into infinite loops. Samuel Feldman asks how 
to customize the Choose Color dialog — which is not so simple due to poor documentation 
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and a bug in Microsoft’s resource compiler. Non-client area tinkering returns this month 
when Michael Rioux asks how to change the system menu icon in a window. Paul provides a 
small but undocumented solution, and provides interesting insights into how Windows 
manages its set of standard bitmaps. Finally, to show how to secretly launch a Windows 
application, Paul supplies code that lets you experiment with the various S W _parameters to WinExecf). 
Paul Bonneau 

Tech Tips: Yet Another Previous Instance and Trapping 
Validation Errors. 61 

James K. Lawless adds to the endless methods for creating single-instance Windows 
programs. Robert Mashlan provides some tips on using Borland’s WinSpector to trap parameter 
validation errors, and points out some misleading documentation of NotifyRegisterf). 

Leor Zolman 

Practical C++: Window Subclassing. 65 

If programmers are to be able to incrementally take advantage of WUIMAN in an existing 
Windows program, WUIMAN has to be able to tinker with someone else's windows and 
window messages. The natural solution is window subclassing, inserting a new message 
handler for a window that functions more or less like interrupt intercepting code in DOS. This 
column looks at the problem of safely subclassing windows and provides a C++ class to do 
all the work. 

Ron Burk 
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Online Source Code 


You can obtain source code for Windows/DOS Developer's Journal (including unpublished code) 
from: 

CompuServe — GO CLMFORUM, section 7. 

GEnie — in the Windows Roundtable at page 1335 (Keyword:Windows). 

USENET (Archived by UUNET Technologies): uunet!~/pub1 i shed/wl ndowsdos/19YY/monYY. zi p 
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Sourcer , , 


! 


Sourcer is the best disassembler 
we’ve ever seen." PC Magazine 


Creates commented source code and list¬ 
ings from binary files. Shows how programs 
work with detailed comments on interrupts, 
subfunctions, I/O functions, and more. Sup¬ 
ports all instructions to 80486 and V20/V30. 

Sourcer provides the best analysis separat¬ 
ing code and data. It automatically deter¬ 
mines data types, uses descriptive labels for 
BIOS and PSP data, and links data items 
across multiple segments. 


New version 5.0 makes most DOS EXE and 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original I 


Top professionals depend on Sourcer for the 
most pliable results with the least effort. 




for Windows 


"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 
Sal Ricclardi PC Magazine 


Windows Source™ with Sourcer generates 
detailed listings of Windows EXEs, DLLs, 
SYSs, VxDs, device drivers & OS/2 NE files. 
Labels, by name, export & import function 
calls, API calls like "GetFreeSpace" and more. 

See the many undocumented Windows 
functions used by professionals to perform 
tricks that are otherwise impossible. 


Comes complete with extra utilities for 
resource extraction and import analysis. 
Uses CodeView symbols for improved clarity. 


BIOS Source 


for PS/2, AT, XT, PC and Clones 

The BIOS Pre-Processor tm with Sourcer 
creates commented listings for any BIOS 
ROM in your PC. Understand how your 
specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Identifies 
multiple interrupt branches with special 
labeling like "int_10_video." Fully automatic. 

Sourcer-Commenting Disassembler $129.95 
Sourcer w/BIOS (save $10) 169.95 

ASMtool 486-Automatic flowcharter 199.95 
ASM Checker-Finds source code bugs 99.95 
Windows Source-requires Sourcer 129.95 
Windows Source & Sourcer-(save $30) 229.90 

Shipping: USA $6; Canada/Mexico $10; Other $18. CA 
residents add sales tax. © 1993 VISA/MasterCard/COD 

30-DAY MONEY-BACK GUARANTEE 

1 - 800 - 648-8266 order desk 

V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 275-WD 
San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 





From 

the Editor 


Multimedia is one of those things that seems destined to seep into our lives, rather 
than break through in one fell swoop as the trade magazines often predict, it is certainly 
seeping into Windows programming, as more applications are beginning to detect and 
take advantage of sound boards, and to use movement rather than just graphics in their 
user interfaces. I am happy to introduce the first of a series of articles by Charles Mirho 
on Windows multimedia programming. As you will see in this first installment, this is not 
high-level, overview stuff - he is presenting hands-on code that you can use to take 
incremental advantage of the multimedia possibilities of Windows in your current appli¬ 
cations. 

The PC C++ compiler wars rage on, with Borland C++ v4.0 representing the latest 
volley. The various PC C++ packages are so large and complex that no simple compari¬ 
son suffices, but Borland has definitely taken the lead in tracking the evolving C++ stand¬ 
ard, including exception handling and run-time type identification (RTTI) in this version. 
Unfortunately, Borland also managed to create a new license agreement that some de¬ 
velopers are finding too onerous to consider using - see the Readers' Forum section for 
more details on this legalistic snafu. 

Several vendors seem to have simultaneously entered the market for compression 
libraries. I haven't had time to examine any of them firsthand yet, but I've got a couple 
of ideas for using them. First, I would like to have an easy way to store arbitrary files as 
compressed resources in my Windows .exe or .dll, where I can read them at runtime. 
Second, I would like to be able to compress the files I store in the 'baggage' section of 
WinFlelp .hip files; good compression is especially important as more help files include 
sound and video files. Both of these applications would require compression libraries that 
let the programmer supply custom file I/O routines, since the raw data would not exist in 
a separate, standalone file. It will be interesting to see if anybody thought to make their 
library that flexible. 

We received no articles for our OLE theme issue, so next month's theme will be C++ 
instead. I'm not sure if the lack of submissions indicates a lack of interest, or merely that 
everyone who knows anything about OLE is up to their armpits in writing code with no 
time for anything else. In any case, it seems likely that Microsoft will tie OLE to Windows 
itself to such a degree that it will be difficult for Windows programmers to avoid learning 
something about it. I expect we will try that theme again next year. 

I don't want to leave you with the idea that next month's issue will suffer due to lack 
of OLE material We have some exciting articles lined up, including how to automatically 
turn your Windows menus into tear-off menus (this is some nifty codel), a C++ class for 
asynchronous file I/O under Windows NT, more bitmap special effects from Charles 
Mirho, and much more. Also, next month (the week of March 13th, in San Jose) is Soft¬ 
ware Development '94, my favorite conference for programmers. If you are planning on 
attending, l hope you will come by the R&D booth to say hello. And if you are one of the 
poor souls trying to implement state-of-the-art online help in Windows, sign up for my 
class on advanced WinHelp programming and meet some fellow WinHelp sufferers. Either 
way, I hope to see you therel □ 

Ron Burk 

Editor 

CIS: 70302,2566', Internet: ronb@rdpub.com ("... luunetlrdpublronb") 
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Develop 

Windows Applications 
Quickly and Easily 


Phase3 Has Everything You Need 


Visual Development 

The Phase3 visual development environment 
provides a comprehensive suite of tools for 
screen creation. All standard Windows 
screen objects - push buttons, radio buttons, 
dialog boxes, etc. - are selectable from icon 
bars and are dynamically placed and sized 
on the screen as appropriate for the 
application. Standard Windows APIs are 
available from list boxes and are supported 
with on-line documentation. 


Phase3 Database 

Phase3 includes a relationally complete 
database supplied as a Windows DLL. The 
database supports complex data relation¬ 
ships and access and data manipulation by 
any language through a comprehensive 
suite of supplied database routines. 
Database integrity is enhanced with 
rollback recovery and transaction control. 
The Phase3 data dictionary simplifies data 
model definition and maintenance. 


Query and Reporting 

The Report Writer includes standard 
features like flexible headers, footers, free 
text, calculated fields, sort group sections 
and breaks, and subtotals. Reports can also 
include bitmaps of drawings and photo¬ 
graphic images. Queries are executed with 
the Database Browser which also allows 
data entry and manipulation. Railway 
diagrams assist in query creation, prompt¬ 
ing the user for appropriate selections and 
eliminating syntactical errors. 



Royalty-Free Applications 

Windows is a trademark of Microsoft Corporation. Turbo Pascal 
for Windows and Borland Pascal 7.0 are trademarks of Borland 
International, Inc. All other trademarks or service marks are 
recognized as the property of their respective owners. 


Lower CASE, E-R Modeling 

Phase3 automates logical data model design 
with Entity-Relationship modeling. After a 
user describes entity relationships graphi¬ 
cally and enters field descriptions, Phase3 
generates the physical database based on an 
analysis of the entity relationships. Phase3 
automatically includes foreign keys in 
appropriate tables and restructures the 
database as requirements change. Phase3 
suggests appropriate referential integrity 
constraints to be enforced at runtime. 


Hierarchy Chart 

Phase3 maintains a graphical map of an entire 
application. The Hierarchy Chart includes all 
windows, dialogs, reports, and code routines. 
To access the underlying C or Pascal source 
code, simply point-and-click on any node. 
Phase3 generated source is easily accessed 
and extended with user written routines. User 
code is preserved even if an application is 
regenerated. The Hierarchy Chart and E-R 
Diagram provide instant core documentation 
for an application. 


Help Generator 

The Phase3 Help Generator allows the easy 
creation of a complete Windows application 
help subsystem including context sensitive 
on-line help. The Help Generator includes its 
own text editor that gives complete control 
over the content, appearance, and branching 
logic through highlighted trigger text. Phase3 
generates a Windows compatible file with an 
“.HLP” extension that is then accessible 
from within the Phase3 created application. 
No other external tools are required. 


“...a thoroughly remarkable product... 
very impressive” 

Jeff Duntemann 

PC Techniques 

▲ ▲ ▲ 

“I was very impressed with Phase3, and using it 
made me wish I had learned Windows programming 
with a tool like this. Now that I know what it has to 
offer, I'll probably use it to build the frame for most 
of my programs.” 

L. John Ribar 

Windows Tech Journal 

▲ ▲ ▲ 

“Phase3 hides the complexity of Windows program¬ 
ming but still allows an experienced programmer to 
drill down and extend generated C or Pascal source 
code, providing ultimate control.” 

Randy Goodhew 

Computer Software Columnist 

▲ ▲ A 

“Phase3 takes an intuitive, innovative approach to 
developing Windows applications. It’s a pleasure to 
work with and has greatly boosted our productivity. 
One of the most important issues for us is that their 
technical support is excellent.” 

Reuben Halevi 

ISoft D&M 


“It's easy to put together an application with Phase3 
- everything's integrated. And the Phase3 database 
is terrific. It’s closer to true relational than anything 
we’ve found.” 

Michael Erickson 

Prism Business Solutions 
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Order Now 

800 - 851-5650 

Or Call for Free Demo Disk 
Fax(805)641-9083 
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Soon available on all platforms: 

MS-Windows, Windows NT, OS/2 PM, Solaris, UNIX on PCs and workstations. 
Your application written with the GSS*CGI Graphic Tools 
will be portable to all platforms. 









Graphics Development Toolkit enables you to develop 
applications in a device and system independent way 
through the help of device-specific drivers based on the 
ISO CGI Standard. GSS’GDT consists of a library with 
more than 160 callable C and FORTRAN functions and is 
compatible with the graphics development tools from IBM 
and SCO. 

GSS’GDT is available for DOS, MS-Windows, Wndows 
NT, OS/2 PM, Interactive Unix, Onsite Unix SVR 4.2 and 
Solaris. 

Versions for SCO Unix, UnixWare and HP Workstations will 
be soon available. 


GSS*GKS 




Graphical Kernel System is a C and FORTRAN function 
library that enables you to develop portable graphic 
applications which include e.g. user interaction, coordinate 
transformation and object segmentation, based on the ISO 
GKS Standard. GSS’GKS, which is installed in large 
quantities on the DOS platform and has been proved 
successful for years, is now available for the graphical user 
interfaces and therefore offers the software developer a 
smooth transition to the new windowing systems. 
GSS’GKS is available for DOS, MS-Windows, Windows 
NT, OS/2 PM, Interactive Unix, Onsite Unix SVR 4.2 and 
Solaris. 

Versions for SCO Unix, UnixWare and HP Workstations 
will be soon available. 


-1 GSS*EVT IS 

EMATEK Vectorfont Toolkit enables you to integrate 
vectorfonts into your application. Supported font formats 
are PCL5, PostScript Type 1, TrueType and Bitstream 
Speedo. GSS’EVT offers a variety of additional elements 
and attribute functions like character height and gap, 
rotation and italicize angle, fill area pattern and outline- 
width, shadow, background boxes, leader and underlining 
as well as sub- and superscripting for scientific purposes. 
GSS'EVT is an add-on for GSS’GDT, GSS’GKS, 
MS-Windows SDK and will be ported to all popular 
graphical user interfaces. 


H GSS*GCT H»l 

Graphics Charts Toolkit provides you with high-level 
functions to integrate presentation graphics into your 
application. Wth only a few calls you can output pie, bar, 
line, step, schedule or text diagrams on a display or 
printer. Each part of the chart can be altered through the 
related attribute functions. GSS’GCT is an add-on for 
GSS’GDT and GSS’GKS and will be ported to all popular 
graphical user interfaces, thus providing portable presen¬ 
tation graphic capabilities for all supported systems. 
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Paul Bonneau 


Send questions to Paul via Internet as 

paul@rdpub.com 

from CompuServe: 

>INTERNET:paul@rdpub. com 
or in care of this magazine at: 

1601 W. 23rd St, Suite 200 
Lawrence, KS 66046-2700. 

Paul answers all electronic 
communications but is unable to 
respond personally to hard copy/disk 
messages. 


Debugging Hung Applications Revisited 

In the September 1993 issue (p. 72 and following), I presented a technique 
for breaking into the execution stream of an endlessly looping Windows task. I 
pointed out (p. 75) that when running Windows in enhanced mode, even 
though you can break into WDEB386 at any time using Ctrl-C, typically you 
will be inside the 32-bit virtual machine manager, not the task's 16-bit execu¬ 
tion stream. I explained that continuing execution to address 0x003b:0220, then 
tracing with the T command would return control to the task's execution 
stream, even though I claimed the technique was "voodoo" (I did not under¬ 
stand how it worked). Since then, I have received an explanation from Neil 
Sandlin, one of Microsoft's Software Design Engineers. 

This does not do what it claims to do, although it does do something that 
some might find useful. What it does do is bring you to the address of the next 
protected-mode instruction that is interrupted by a timer tick. However, there are 
numerous caveats associated with this trick. 

What this trick does is to stop at a special breakpoint address that coinciden¬ 
tally is one of the addresses the system uses for simulating virtual IRQO (timer) 
interrupts. Note that it is possible that this address would be a different value if 
you had some VxD in the system that requested certain system resources (for 
example, protected-mode breakpoints) at a specific moment. In that case, this trick 
would not behave the same way. 

To demonstrate that this is not a very special address, try using instead the 
address "3b:234", or "3b:230". You will see that the breakpoint will not happen 
until you hit the keyboard (you may have to hit it a couple of times, it depends on 
what context the interrupts actually occur in). 

So, if you follow the instructions of this trick, what really happens is: 

• Ctrl-C brings you down to the internal debugger breakpoint. 

• 'g 3b:220" says: restart execution, and break when the system hits that ad¬ 
dress. 

• The system continues, and probably executes more instructions in the 'active 
task". In fact, lots and lots of code may be executed before you stop again. 

• The next time the system is in protected mode and a timer tick occurs, then the 
breakpoint set earlier will eventually be hit. Stepping through it actually exe¬ 
cutes more code internally, and you finally end up back where the timer tick 
happened. 

Note that if you are running a full-screen exclusive VM (e.g., a DOS box) at the 
command prompt, you never hit the breakpoint set by 'g 3b:220". That's because 
the system does not enter 'user-mode' protected mode any more. 


Paul Bonneau is a Software Design Engineer at a major software firm. He was a devel¬ 
oper of HyperChem, a molecular modeling system marketed by Autodesk. 


























Introducing 
Remind Me!’ 
for Windows 

The easy and 
fun way 
to remember 
important events. 


Animated Looney Tunes 
characters bnng 
your multi-media 
computer to life. Plus 
actual cartoon sound 
tracks. This powerful 
agent can automatically 
load files, run programs, 




and deliver messages at 
the day and 
time you select 
You choose 
from over 
20 images of 
Bugs and all his pals that 
burst onto the screen - 
you'll never again miss an 
important event 


REMIND ME! 
does lots more. 

So, see your 
software dealer, 
or call us toll-free: 
I -800-VLOCITY. 



© 1993 Velocity'. All rights reserved. 
Velocity and Remind Me! are trademarks of 
Velocity Development Corporation. Looney 
Tunes, characters, names and all related indicia 
are trademarks of Warner Bros.© 1993. 


So the trick may prove useful but 
is not guaranteed to work. Specifi¬ 
cally, it will not work from a full¬ 
screen DOS box, nor if you have a 
VxD that has allocated protected- 
mode break points. It will not break 
into the execution stream of your 
task following the last instruction that 
was executed after typing Ctrl-C, but 
somewhere further in the execution 
stream. This is not really important, 
since the break into the debugger is 
asynchronous anyway (it happens in 
real time). 

In a subsequent conversation, 
when I asked Neil how he would 
break into the execution stream of a 
program, he gave this reply: 

Well, there are two methods 
that I use, but they both require ex¬ 
tra 'stuff'. 

The first requires the debug ver¬ 
sion of win386.exe from the DDK. 
This is the one that is over 1Mb 
large. With this installed you get a 
whole bunch of neat commands. 
The one that would work in this 
case is to do a . vr, or a . m. These 
commands will dump the register 
state for the current virtual ma¬ 
chine. You can then do a 9 
xxxx-.yyyy, filling in the virtual 
CS:(E)IP retrieved by the dump. 
You have to be a bit careful here, 
because the virtual machine may 
be in V86 mode at the time (you 
need to prefix CS:IP with a &); if 
you are running a 32-bit app, you 
may need to specify the whole EIP. 
This method is more complicated, 
but it is at least accurate and reli¬ 
able. 

By far the simplest method from 
a debugging perspective would be 
to install a debugging board that 
can generate NMI interrupts with a 
switch. When you hit the switch, 
WDEB386 stops you right at the in¬ 
terrupted instruction. This is also 
ideal because you can debug things 
that clear the interrupt flag and go 
into an infinite loop, which would 
normally lock up your entire sys¬ 
tem. 

You know, the trick you men¬ 
tioned may not be all that bad for 
people who are working on a Win¬ 
dows application, and are running 
on a pretty vanilla system. It's easy 
to remember, uncomplicated, does 
not require extra 'stuff'. And al¬ 
though it does not return you im¬ 
mediately to the interrupted instruc¬ 
tion, it does get you out of WIN386 


and into application code. It would 
be useful if your application is in a 
tight loop, where you do not really 
need to be so precise in where you 
return. But another case where it 
would fail would be if the system 
was hung in some network TSR or 
DOS device driver; you would 
never hit the breakpoint there, 
either. 

N eil's first suggestion, about 
dumping the state of the current 
VM had never occurred to me, and 
ail I ever use is the DDK's debug ver¬ 
sion of win386.exe\ It is a much better 
way to break into an application's 
execution stream, since no extrane¬ 
ous application code will have been 
executed from the time you break 
into the debugger with Ctrl-C until 
the time you set a breakpoint on the 
CS:(E)IP of the interrupted applica¬ 
tion and continue execution to the 
breakpoint. The only problem arises 
if you have multiple VMs running. In 
this case, Ctrl-C may break into the 
debugger when the current VM is a 
DOS box. You can view the system 
VM from this state by specifying its 
VM handle to the .m or .vr com¬ 
mand, (you can get a list of the cur¬ 
rent VMs with the . vl command), but 
it is tough to set a breakpoint since 
its LDT will not be the current one. 

His second suggestion is also valu¬ 
able. Generating an NMI is the fastest 
way to break into the debugger, and 
the point about debugging when in¬ 
terrupts are cleared is important. I 
once had to debug a situation where 
a particular execution path though 
an early beta version of Windows 
3.0 would leave the computer 
'hung.' The problem turned out to be 
a piece of code that cleared inter¬ 
rupts, then returned via a path that 
did not restore interrupts. 1 did not 
have an NMI switch, and had to use 
a "binary search' to narrow down the 
problem to this particular piece of 
code. It took hours, and the problem 
was aggravated by the fact that I did 
not know the hang was due to an 
unmatched CLI instruction. If I had 
used an NMI switch, I would have 
found out almost immediately what 
was causing the problem, and would 
have known what to look for. 
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Using the NMI switch to get back 
into the execution stream of your ap¬ 
plication may still require the same 
technique as in Neil's first suggestion, 
and therefore the debug version of 
win386.exe. This is because you may 
have broken inside the VMM or an¬ 
other VM. 

Thanks to Neil Sandlin for unveil¬ 
ing yet another Windows mystery. 


Borland C++ v3.1 
Microsoft C/C++ v8.0 
Symantec C++ v6.0 


Q ln Windows 3.1, my users need 
to be able to choose a custom 
color. Of course I first looked at using 
the standard color dialog in 
commdlg.dll. The Choose Color com¬ 
mon dialog, though, has two parts: 
on the left, it lets the user choose 
from a "standard' color or an already 
existing 'custom' color. On the right, 
it lets the user define a new custom 
color. But I'm only interested in the 
part on the right: letting the user 
choose a new custom color. My users 
don't need or want any of the other 
claptrap provided on the left side of 
the dialog box. 

My first question is: can I still use 
the common dialog, and if so, how? 
Would I just intercept the UM_INITDIA- 
LOG and modify the size of the win¬ 
dow, moving all the controls over to 
the left so that the controls I don't 
want are off the dialog to its left? 
(Can dialog units be negative?) Or do 
I also need to make them invisible, 
or disable them? I suppose I would 
also have to worry about the tabbing 
order and grouping. 

My second question is: if I am not 
able to use the common dialog, then 
how do you suppose Microsoft is 
coding the color picker - or a better 
question, what would be the best 
way to code this? The bitmap of 
saturation/hue (the 'color refiner 
box') is apparently constructed on 
the fly, since there is no bitmap re¬ 
source in commdlg.dll corresponding 
to it; the bitmap for the luminosity 
bar is quite definitely constructed on 
the fly, as in fact it changes on the 
fly to match the user's selection in 


Real UNIX SVR4 Tools 
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Figure 1 A modified Choose Color dialog 


the color refiner box. How do you display smooth color 
gradients like this? Lots and lots of calls to BitBltO? 

My third question is: if all of the above ends up being 
too much work, do you know of any third-party control 
libraries that include a color picker? The ones I've seen 
advertised seem to give you toolbars, tables, etc., but 
none mention anything about color pickers. 

Samuel Feldman 
CIS: 70403,432 

A You can use the Choose Color common dialog, al¬ 
though it certainly is not obvious from the documen¬ 
tation. Like other common dialog functions, the Choose 
Color dialog is passed a structure that can supply a cus¬ 
tom dialog template and/or dialog hook procedure (the 
dialog hook procedure is called by the common dialog's 
internal Choose Color dialog procedure). The idea is to al¬ 
low you to create your own custom version of the tem¬ 
plate, placing the controls you don't need outside the cli¬ 
ent area of the dialog to make them invisible and dis¬ 
abling them to remove them from the tabbing order. But 
nowhere that I can find does the documentation say what 
controls comprise the Choose Color dialog template, or 
even what their IDs should be. 

It turns out that the answers are in several SDK files. 
The dialog templates for all the common dialogs can be 
found in the SDK's samples directory, in the subdirectory 
commdlg. Core control IDs shared by the dialogs are in the 
header file dlgs.h in the SDK's include directory, and the 


Listing 1 colordlg.rc — Resource definitions for custom Choose Color dialog 


j******★★★★★*★*★★★★★★★★****★*★★*★★★**★★**★*★*★★***★★*★i 


/* colordlg.rc */ 
/* -- Customized version of color.dig found in the */ 
/* SDK’s samples\commdlg directory. This version */ 
/* only presents the "rainbow control" half of */ 
/* the dialog. */ 


/ ******** ********** ****** ****** *********** ************ j 

#include <windows.h> 

#include <colordlg.h> 

#include <dlgs.h> 

ChooseColor DIALOG LOADONCALL MOVEABLE DISCARDABLE 
2, 0, 152, 184 
CAPTION "Color" 

STYLE WS_B0RDER I DS_MODALFRAME I WS_CAPTION I 
WS_P0PUP | WS_SYSMENU 
FONT 8 "Helv" 

BEGIN 

CONTROL C0L0RJ0X1, "static", 

SSJIMPLE | WS_CHILD, -100, -100, 0, 0 
CONTROL COLORJUST0M1, "static", 

SS_SIMPLE I WS_CHILD, -100, -100, 0, 0 
PUSHBUTTON "SDefine Custom Colors..." C0L0RJIIX, 
-100, -100, 0, 0, W$_GR0UP 
DEFPUSHBUTTON "OK", IDOK, 

4. 166, 44, 14, WSJSROUP I WSJABSTOP 
PUSHBUTTON "Cancel", IDCANCEL, 

52. 166, 44, 14, WSJSROUP I WS_TABSTOP 
PUSHBUTTON "&Help", pshHelp, 

100, 166, 44, 14, WSJ3R0UP 
CONTROL "". COLORJAINBOW, "static". 


SS_BLACKFRAME | WS_CHILD, 4, 4, 118, 116 
CONTROL COLORJUMSCROLL, "static", 

SS_SIMPLE I WSJHILD, 132, 4, 8, 116 
CONTROL COLOR_CURRENT, "static", 

SS_BLACKFRAME I WSJHILD, 4, 124, 40, 26 
CONTROL ”&o", COLOR_SOLID, "button", 

BSJUSHBUTTON I WSJSHILD, 152, 200, 4, 14 
RTEXT "Colorl", -1, 4, 151, 20, 9 
LTEXT "S&olid", -1, 24, 151, 20, 9 
RTEXT "JHue:", COLORJUEACCEL, 46, 126, 20, 9 
EDITTEXT, COLORJUE, 

68 , 124, 18, 12, WSJSROUP I WS_TABSTOP 
RTEXT "iSat:", COLORJATACCEL, 46, 140, 20, 9 
EDITTEXT, COLORJAT, 

68 . 138, 18, 12, WS_GROUP I WSJABSTOP 
RTEXT "&Lum:", COLORJUMACCEL, 46, 154, 20, 9 
EDITTEXT, COLOR_LUM, 

68 , 152, 18, 12, WS_GROUP I WS_TABSTOP 
RTEXT "4Red:", COLOR.REDACCEL, 95, 126, 24, 9 
EDITTEXT, COLOR_RED, 

121, 124, 18, 12, WS_GROUP I WSJABSTOP 
RTEXT "SGreen:", COLOR_GREENACCEL, 95. 140, 24, 9 
EDITTEXT. COLORJSREEN, 

121, 138, 18, 12, WSJSROUP I WSJABSTOP 
RTEXT "Bl&ue:", COLOR_BLUEACCEL, 95, 154, 24, 9 
EDITTEXT, COLORJLUE, 

121, 152, 18, 12, WSJSROUP I WSJABSTOP 
CONTROL "&Add to Custom Colors”, COLOR_ADD, 
"button". BSJUSHBUTTON I WSJHILD, 

- 100 , - 100 , 0 , 0 

END 
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remaining specific Choose Color control IDs are in the 
header file colordlg.h, also in the SDK's include directory. 

colordlg.rc (Listing 1) is a customized version of 
color.dig, the resource file describing the Choose Color 
dialog. I have moved all unwanted controls to location 
(-700, -700) placing them off the dialog's client area. I also 
moved the remaining controls to the left, to occupy the 
space once occupied by the unwanted controls. One of 
the interesting things about the design of this dialog is 
that four pseudo controls are drawn directly on its client 
area. These are the upper-left grid of Basic Colors, the 
lower-left grid of Custom Colors, the large 'rainbow'' con¬ 
trol occupying most of the right side, and the pair of adja¬ 
cent rectangles that display the current colors (one half 
shows the current dithered color, and 
the other half shows the closest solid 
color). The location of the pseudo 
controls is determined by the place¬ 
ment of three corresponding static 
controls, C0L0RJ0X1, C0L0R_CUST0M1, 
and C0L0R_RAINB0U. The static controls 
are used to frame the pseudo con¬ 
trols. 

i simply deleted from the template 
any unwanted static text controls 
that were merely used as titles. The 
Choose Color dialog procedure does 
not reference these controls, so delet¬ 
ing them is benign. This does not 
hold true of some of the other un¬ 
wanted controls. For example, if you 
omit the C0L0R_ADD push button, the 
Choose Color dialog procedure will 
generate numerous RIPs during its in¬ 
itialization, as it makes calls to a non¬ 
existent window. 

I also removed the US_TABSTOP style 
from any of the controls that were 
moved off the dialog's client area. It 
turns out that this is not sufficient. 

Regardless of what is specified in the 
dialog template, the C0L0R_ADD and 
C0L0R_S0LID controls will have the 
USJABSTOP style. The C0L0RJ0LID con¬ 
trol, a push button with title text "&o" 

(the is an escape and indicates the 
next character is a mnemonic and 
should be underlined), is always in¬ 
visible, by design. This control pre¬ 
cedes the two static controls la- 
beIed"Co7or/' and ‘S&olicT, which to¬ 
gether are used as the title of the 
current color pseudo control. When 
the user presses Alt-o, the current 
color is "snapped" to the closest solid 
color. This is made possible by the hid¬ 
den push button, as I will describe. 

When the user enters a control's 
mnemonic, the dialog manager per¬ 
forms a case-insensitive search for 


the first control possessing the "<5"-escaped mnemonic in 
its title text. If the control is not static (for example, a static 
or group box control) it is "activated" by the dialog man¬ 
ager. Activation depends on the type of control, which is 
determined by the control's response to the UM_GETDLGCODE 
message. When the dialog manager activates a push but¬ 
ton, it sends a pair of BM_SETSTATE messages to the push 
button to make it appear as if it had been pushed in and 
then released. The dialog manager then sends a UM_C0M- 
MAND with a BN_CLICKED notification to the dialog procedure, 
so that the dialog will behave as if the user had pushed 
the push button. 

Since the static text item with the title ‘S&olicT is not 
capable of being activated, a hidden push button with the 
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same mnemonic is used. The weird thing is that this hid¬ 
den control has the US_TABSTOP style. You can see this if 
you create an unmodified Choose Color dialog (don't sup¬ 
ply a template or a hook procedure). If the focus is on the 
Cancel button, pressing the Tab key will move the focus 
to the invisible control: to the user it appears as if the 
focus has vanished I 

The culprit is the resource compiler. Whenever it sees a 
control of type PUSHBUTTON in a dialog template, it automat¬ 
ically adds the US_TABSTOP style. Maybe this undocumented 
'feature' is intended for the forgetful programmer, but its 
existence can only be considered a bug, especially in light 
of what the SDK's online documentation has to say for 
the PUSHBUTTON resource statement: 

style 

This optional parameter specifies styles for the pushbut¬ 
ton, which can be a combination of the BS_PUSHBUTTON style 
and the following styles: US_TABSTOP, WSJISABLED, and 
HS_GR0UP. 

As if you had some free choice in the matter. Fortunately, 
there is a way around this bug. Controls can also be de¬ 
clared using the syntax: 

CONTROL text, id, class, style, 
x, y. width, height 


CONTROL "&o". C0L0RJ0LID, "button”, 

BS_PUSHBUTTON | WS_CHILD, 

152, 200, 4, 14 

the resource compiler does not add the US_TABSTOP attrib¬ 
ute. 

colordlg.rc (Listing 1) uses this method for declaring 
the unwanted C0L0R_ADD push button as well, colordlg.c 
(Listing 2) is a tiny demonstration program that displays 
the modified Choose Color dialog (see Figure 1). The pro¬ 
gram puts up a message box with the chosen color if the 
user dismisses the dialog with the 'OK' push button. 

The code simply initializes a CH00SEC0L0R structure and 
passes its address to the ChooseColorO function exported 
by commdlg.dll. To specify a custom dialog template, you 
supply the instance handle of the task/DLL containing the 
template resource, as well as the resource name. This fea¬ 
ture allows you to bundle a custom Choose Color dialog 
template resource into a separate DLL (why you would 
want to is another question). Whoever defined the CH00SE- 
COLOR structure was rather sloppy, since the type of the 
hlnstance field is declared as type HUND\ Flence the cast in 
colordlg.c (Listing 2) when assigning the instance handle. 

There is one final point worth mentioning. If you run 
the debug version of Windows, every time you run the 
demo program you will be given two warnings when it is 
terminated: 


When a push button is defined this way: 


Listing 2 colordlg.c — Simple demonstration of 
custom Choose Color dialog 



/* colordlg.c */ 

/* -- Program demonstrates customizing the standard */ 

/* color dialog. */ 

/* -- To build: "cc -DSTRICT colordlg.c commdlg.lib" */ 
/*****************************************************/ 
♦include <windows.h> 

♦include <commdlg.h> 

♦include <colordlg.h> 

♦ifdef _BORLANDC_ 

♦pragma argsused 
♦endif 

int PASCAL WinMalnCHINSTANCE bins, HINSTANCE hinsPrev, 

LPSTR lpsz, int wShow) 

{ 

CH00SEC0L0R chc; 

COLORREF rgclr[16]; 

chc.lStructSize ■ sizeof chc; 

chc.hwndOwner = NULL; 

chc.hlnstance = (HWND)hins; 

chc.lpCustColors = rgclr; 

chc.Flags = CC.FULLOPEN I CC.ENABLETEMPLATE; 

chc.lpTemplateName = "ChooseColor"; 

if (ChooseColordchc)) 

{ 

char szBuf[128]; 

wsprintf(szBuf, "RGB = (Xd. Xd. Xd)". 

GetRValue(chc.rgbResult), 

GetGVal ue(chc.rgbResult). 

GetBVal ue(chc.rgbResult)); 

MessageBox(NULL, szBuf, "ColorDlg", MB_0K); 

} 

return 0; 

} 

/* End of File */ 


wn COLORDLG GDI: DC not deleted: 0xXXXX 
wn COLORDLG GDI: Bitmap not deleted: OxYYYY 

Don't worry, the dialog is not really leaking GDI objects. 
The problem is the way the debugging version of Win¬ 
dows reports potential leaks. The common dialog code 
does indeed make many iterations of creating a colored 
brush and painting a small rectangle of the 'rainbow' bit¬ 
map. This is a very time-consuming process. So 
comdlg.dll saves the resultant bitmap handle inside a 
static variable, on the off chance that if another invoca¬ 
tion of the Choose Color dialog is made while the DLL is 
still loaded, the DLL can then 'share' the bitmap and save 
the expense of regenerating it. The bitmap and the 
screen-compatible device context containing it are not 
freed until the DLL's UEPO is called. In the case of an im¬ 
plicitly linked DLL, this occurs after task termination. But 
debug USER code is invoked during task termination to 
report on all dangling GDI objects, and it has no way of 
knowing that the bitmap and device context are really 
owned by the DLL, not the task. 


=E3; 


Borland C++ v3.1 
Microsoft C/C++ v8.0 
Symantec C++ v6.0 


Q l have looked for clues on how to change the sys¬ 
tem menu's icon (the icon in the upper right-hand 
corner of a captioned window), and can find none in your 
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Figure 2 Windows’internal window bitmap bar 
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Figure 3 a customized Windows window bitmap bar 


work, the Microsoft Developer's Net¬ 
work CD, or any of my other sources. 

Basically, what I would like to do is 
put my company's logo in the space 
normally used by the system menu's 
icon. I dug around a little with Bor¬ 
land's Resource Workshop and found 
the bitmap and bitmap identifier. The 
identifier is 65535 and is in vga.drv 
and supervga.drv. If I know the identi¬ 
fier, is there a way to get the handle 
to the bitmap and then somehow re¬ 
place it? Will all of the windows then 
have that new bitmap or will just my 
application? I have seen this done 
before (in applications created by hDc); maybe I should 
snoop around their stuff to get an idea how I could do it. 

Michael Rioux, NWU 
mrioux@ftp.com 

A I can think of several ways to approach your prob¬ 
lem, but none of them is clearly superior. So let me 
describe what these approaches are and present code for 
one of them. 

The most ambitious method is to draw the entire non¬ 
client area yourself. This gives you complete control over 
the appearance and behavior of every element of the 
non-client area but means you have to write a good deal 
of code. Basically, you have to provide code to handle 


most of the non-client messages. Windows sends 
UH_NCPAINT and UM_NCACTIVATE messages to a window when 
its non-client area needs to be redrawn, and sends a 
UM_NCHITTEST message when it is determining which part of 
a window the user clicked on. The response to this mes¬ 
sage determines how Windows reacts to the click. For ex¬ 
ample, returning HTZOOM will cause Windows to maximize 
the window (it does so by sending a UM_SYSCOMMAND mes¬ 
sage with a wParam of SC_ZOOM). 

Another important message to handle is WMJCCALCSIZE. 
Your code informs Windows of the size and position of 
your client area within the entire window via the rectangle 
returned in the rgrc[0] member of the NCCALCSIZEJARAMS 
structure, whose address is passed in IParam. Therefore the 
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Listing 3 sysicon.c — Code to implement custom system menu icon 

j *****************************************************/ 

"Custom System Icon Demo". WS OVERLAPPEDWINDOW, 

/* sysicon.c */ 

CW USEDEFAULT, CW USEDEFAULT, CW USEDEFAULT, 

/* -- Display a custom system menu icon. */ 

CW USEDEFAULT, NULL, NULL, hins, NULL)) 1= NULL) 

/* -- To compile: */ 

{ 

/* cc -DSTRICT sysicon.c tool help, lib */ 

ShowWindowthwnd, wShow); 

/*****************************************************/ 

while (GetMessageUmsg, NULL, 0, 0)) 

#include <windows.h> 

#include <toolhelp.h> 

{ 

TranslateMessage(&msg); 

DispatchMessage(&msg); 

/* Class name and bitmap resource name. */ 

} 

char szName[] = "Syslcon"; 

} 

/* Location of USER'S memory DC. */ 

LCleanup: 

HDC far * lphdc; 

DeleteObj ect(hbmpMySys ) ; 
if (hbmpMySysBar != NULL) 

/* Custom system bitmap bar. */ 

HBITMAP hbmpMySysBar; 

DeleteObjectthbmpMySysBar); 
return msg.wParam; 

} 

/* Offset of USER memory DC inside USER DGROUP. */ 

#define bhdcRetail 0x0120 

LRESULT CALLBACK export 

tfdefine bhdcDebug 0x0162 

LwWndProc(HWND hwnd, UINT wm, WPARAM wParam, 


LPARAM lParam) 

LRESULT CALLBACK export 

j★★****★**★*★*★*★★****★**★************★*★*★*★★**★★★★*★j 

LwWndProciHWND hwnd, UINT wm, WPARAM wParam, 

1* ■■ Main window procedure. */ 

LPARAM lParam); 

!*****************************************************j 
{ 

LRESULT lwVal ; 

HBITMAP HbmpPatchBmptHBITMAP hbmp, HDC hdcMem); 

int PASCAL WinMainCHINSTANCE hins, HINSTANCE hinsPrev, 

switch (wm) 

LPSTR lpsz, int wShow) 

{ 

{ 

default: 

HWND hwnd; 

MSG msg; 

break; 

SYSHEAPINFO shi; 

case WM_DESTROY: 

WINDEBUGINFO wdi; 

PostQuitMessage(0); 

HBITMAP hbmpMySys; 

UINT bhdc; 

break; 

if (hinsPrev == NULL) 

{ 

WNDCLASS wcs; 

case WM NCPAINT: 
case WM NCACTIVATE: 

{ 

HBITMAP hbmpSav; 

wcs.style = 0: 

/* Temporarily replace the system bitmap */ 

wcs.lpfnWndProc = LwWndProc: 

/* bar in USER’S memory DC with our own, let */ 

wcs.cbClsExtra = 0: 

/* DefWindowProcO do its thing, and replace */ 

wcs.cbWndExtra = 0; 

/* the original bitmap. */ 

wcs.hlnstance = hins: 

hbmpSav = SelectObject(*lphdc, hbmpMySysBar); 

wcs.hlcon = Loadlcon(NULL, IDI APPLICATION); 

lwVal = 

wcs.hCursor = LoadCursor(NULL, IDC ARROW); 

DefWindowProc(hwnd, wm, wParam, lParam); 

wcs.hbrBackground = (HBRUSH)(C0L0R_WIND0W + 1); 

SelectObject(*lphdc, hbmpSav); 

wcs.lpszMenuName = NULL; 

} 

wcs. 1pszClassName = szName; 

return lwVal; 

if (IRegisterCIass(&wcs)) 

} 

return 0; 


} 

return DefWindowProc(hwnd, wm, wParam, lParam); 

} 

msg.wParam = 0; 


HBITMAP 

/* Get pointer to USER'S memory DC. */ 

HbmpPatchBmptHBITMAP hbmp, HDC hdcMem) 

shi.dwSize = sizeof shi; 

! *★★**★**★**★***★*★★***★★★*************★★*★★★*★★•*•★★★★★ j 

SystemHeapInfo(&shi); 

1* -- Create a system bitmap bar clone with the */ 

bhdc = GetWinDebugInfo(&wdi, 0) ? 

/* first bitmap replaced with the given one. */ 

bhdcDebug : bhdcRetail; 

/* -- hbmp : Custom system menu icon bitmap. */ 

lphdc = (HDC far *)MAKELP(shi.hUserSegment, bhdc); 

/* -- hdcMem : Memory DC containing system bitmap */ 

/* bar. */ 

/* Make a custom copy of the system bitmap bar. */ 

j **★★★★*★★★*★★**★***********★★***★*★**★★★*★*★**★★*★★★★ j 

if ((hbmpMySys = LoadBitmap(hins, szName)) == NULL) 

{ 

return 0; 

BITMAP bmpSysBar, bmp; 

if ((hbmpMySysBar = HbmpPatchBmpthbmpMySys, 

HBITMAP hbmpSysBar, hbmpNew; 

*1phdc)) == NULL) 

HDC hdcMemT; 

goto LCleanup; 

/* Get dimensions of system bitmap bar and */ 

/* Create a window to show off the custom system */ 

/* custom system menu icon bitmap to substitute */ 

/* menu icon. */ 

/* at start. */ 

if ((hwnd = CreateWindowtszName. 

if ((hbmpSysBar = SelectObjectthdcMem, hbmp)) == 
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Listing 3 continued 


NULL) 

bmpSysBar.bmHei ght. hdcMem. bmp.bmWidth, 0, 

return NULL; 

SRCCOPY); 

GetObjectlhbmpSysBar, sizeof bmpSysBar, 


NbmpSysBar); 

/* Copy custom system menu icon bitmap. */ 

GetObjectlhbmp, sizeof bmp, &bmp); 

hbmpSav = SelectObjectChdcMem, hbmp); 

SelectObj ect ( hdcMem, hbmpSysBa r ) ; 

StretchBlt(hdcMemT, 0, 0, bmpSysBar.bmHeight. 
bmpSysBar.bmHeight. hdcMem, 0, 0, 

/* Create custom version of system bitmap bar */ 

bmp.bmWidth, bmp.bmHeight, SRCCOPY); 

/* and fill with bits from custom system menu */ 

if (hbmpSav 1= NULL) 

/* icon bitmap and remainder of original system */ 

SelectObj ect ( hdcMem, hbmpSav); 

/* bitmap bar. */ 

if (hbmpSavT != NULL) 

if ((hbmpNew = CreateBitmapfbmpSysBar.bmWidth, 

SelectObjectlhdcMemT, hbmpSavT); 

bmpSysBar.bmHeight. bmpSysBar.bmPlanes, 

DeleteDC(hdcMemT); 

bmpSysBar.bmBitsPixel. NULL)) == NULL) 

1 

return NULL; 

else 

if (( hdcMemT * CreateCompatibleDC(hdcMem)) != NULL) 

{ 

{ 

DeleteObject(hbmpNew); 

HBITMAP hbmpSav, hbmpSavT; 

hbmpNew » NULL: 

) 

/* Copy right part of original system */ 

/* bitmap bar. */ 

return hbmpNew; 

hbmpSavT = SelectObjectlhdcMemT, hbmpNew); 

1 

BitBltthdcMemT, bmp.bmWidth. 0, 

1 * End of File */ 

bmpSysBar.bmWidth - bmp.bmWidth, 



response to this message determines the shape of the 
non-client area. (Normally, when your application relies on 
the windows default nonclient area, DefUindouProcO han¬ 
dles all these messages for you.) An alternative to this 
approach was presented by Fran Finnegan in the August 
1993 issue of Microsoft Systems Journal. His solution to a 
custom non-client area is to use a series of popup win¬ 
dows outside of the client area to emulate a non-client 
area. Because all you want to do is change the appear¬ 
ance of the system menu icon, neither of these ap¬ 
proaches is satisfactory, since both require such a heavy 
investment in code. 

Another solution is to allow Windows to paint the non¬ 
client area when a MACPAINT or UM_NCACTIVATE message is 
received, and then have your code repaint the system 
menu icon. Problems with this approach include determin¬ 
ing the position of the system menu icon (it can appear in 
up to three different positions relative to the upper-left 
hand corner of the window, depending on the border 
style), the 'flashiness' in the display that occurs whenever 
that part of the non-client area is redrawn, and the inabil¬ 
ity of the code to anticipate future window styles that 
could cause the system menu icon to appear somewhere 
else in the non-client area. 

The approach I used in the August 1993 Q&A would 
work - intercepting the GDI call to display the bitmap. By 
intercepting the call to BitBltO, the intercepting code can 
determine the exact location of the system menu icon bit¬ 
map, regardless of window style. But the interception rou¬ 
tine must be able to discern the BitBltO call for the sys¬ 
tem menu icon bitmap from the minimize and maxi¬ 
mize/restore icon bitmaps on the right-hand size of the 
non-client area. Also, shipping code that intercepts live 
Windows API calls is not a decision to be made lightly, 
and is hard to justify for a purely cosmetic result. 

Before explaining my last approach, I need to digress a bit 
and explain how Windows draws the bitmap components of 


Listing 4 sysicon.rc — Resource definition for 
sysicon.exe 


/************************************+★*************★*j 

/* -- Resource file for custom system icon demo. */ 

I ******************************************************** j 

Syslcon BITMAP sysicon.bmp 
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Figure 4 Demonstration application with 
customized system menu icon 


Listing 5 launch.h — Header file for launch.exe 


/* quietxec.h */ 
/* -- Dialog resource consntants for silent */ 
/* application launcher. */ 

/★★*************************************************** j 

#define dlgLaunch 1000 
#define didFileName 1001 
#define didStyle 1002 
/* End of File */ 


Listing 6 launch.c — Source for Windows 
application launch program 


I ***************************************************** j 

/* launch.c */ 

/* -- Launch a Windows application. */ 

/* -- To build : cc -DSTRICT launch.c */ 

I *****************************************************/ 

ifinclude <windows.h> 
jfinclude "launch.h" 

/* ShowWindowO style in numerical order. */ 
char * rgszStyle[] * 

{ 

"SWJIDE", "SWJORMAL". "SW.SHOWMINIMIZED", 
"SW_MAXIMIZE", "SW_SHOWNOACTIVATE". "SW_SH0W", 
"SW_MINIMIZE", "SW_SHOWHINNOACTIVE", "SWJHOWNA". 
"SW_RESTORE" 

1 : 

#define cszStyle \ 

(sizeof rgszStyle / sizeof rgszStyle[C]) 

/* Maximum command string length. */ 

#define cchCommandMax 1024 

BOOL CALLBACK _export LwDlgProcfHWND hwnd. UINT wm, 

WPARAM wParam, LPARAM IParam); 

fifdef _BORLANOC_ 

ifpragma argsused 
#endif 

int PASCAL WinMainCHINSTANCE hins, HINSTANCE hinsPrev, 

LPSTR lpsz, int wShow) 

{ 

return DialogBoxChi ns, MAKE INTRESOURCECdlgLaunch). 

NULL. LwDlgProc); 

) 

BOOL CALLBACK _export 

LwDlgProc(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

^******** It******************************************** j 

/* -- Launch dialog procedure. */ 

/*****************************************************/ 

( 

switch (wm) 

( 

default: 

break; 

case WMJNITDIALOG: 

( 

int isz; 


the non-client area. As you have found, it is up to the 
video driver to export the various bitmaps Windows uses 
in its non-client user interface. The reason for this is that the 
size of the various bitmaps depends on the resolution of the 
device. For example, on a VGA, the size of the system 
menu bitmap is 18 pixels square. But on a higher resolu¬ 
tion display, this number is much larger, since otherwise 
the icon would be so small it would be hard to see. If you 
look in the online SDK documentation's description of 
LoadBitmapO, you will see a nice picture of each of these 
bitmaps, and the corresponding resource ID (they are //de¬ 
fine' d in windows, h, but compile only if you have //define' d 
OEMRESOURCE before including windows, h). 

During its initialization, Windows concatenates all these 
bitmaps into one long thin bitmap (see Figure 2), creates a 
memory device context, and selects the bitmap into the 
memory device context. I'm going to call this bitmap the 
'bitmap bar.' When Windows needs to draw one of the 
bitmaps making up the bitmap bar (usually because your 
window procedure called DefUindowProcO to handle a non- 
client window message), it need only call BitBltO, using 
the correct portion of the bitmap bar as the source. The 
system menu icon bitmap is the first bitmap in the bitmap 
bar. 

Windows' technique is much faster than loading a bit¬ 
map from scratch - calling LoadBitmapO to get the bitmap 
from the video driver, calling CreateCompatibleDCO to get a 
memory device context, selecting the bitmap into the 
memory device context, performing the BitBltO, then 
cleaning up by selecting the original bitmap back into the 
memory device context, deleting the memory device con¬ 
text, and deleting the bitmap. 

My final idea is to exploit Windows' memory device 
context by selecting in a customized version of the bitmap 
bar whenever the target window receives a UM_NCPAINT or 
UM_NCACTI VATE message, calling DefUindowProcO to update 
the non-client area, and restoring the original bitmap. The 
advantages include a small amount of code, a solution 
that is independent of the system menu icon bitmap's lo¬ 
cation, and no flashiness. The big disadvantage is that the 
location of Windows' bitmap bar memory device context 
is undocumented; it resides in USER'S (USER is the Win¬ 
dows DLL that handles most user interface functions) 
DGROUP at offset 0x0120 in the retail version and offset 
0x0162 in the debug version of Windows 3.1. This probably 
will not be true of a future version of Windows, if a future 
version even uses the optimization of a bitmap bar. Nev¬ 
ertheless, I present code using this solution since it is small 
and novel; background for each of the other techniques 
can be found in the SDK documentation or previous 
magazine articles. 

sysicon.c (Listing 3) is a demonstration program that 
creates a window with a custom system menu icon, sysi- 
con.rc (Listing 4) refers to a custom system menu icon bit¬ 
map that I created (available on the code disk, see Table 
of Contents for information). UinMainO's initialization code 
first obtains the address of USER'S memory device context 
containing the system bar. The code calls GetUinDebuglnfoO 
to determine if it is running under retail or debug Windows, 
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since the offset of USER'S memory device context variable 
depends on the version. GetUinDebuglnfoO returns zero for 
retail, non-zero for debug. 

A custom system menu icon bitmap resource is next 
loaded and supplied to the helper routine HbmpPatchBmpO, 
which will create a copy of the bitmap bar with the cus¬ 
tom system menu icon bitmap substituted for the standard 
system menu icon bitmap. The routine assumes the sys¬ 
tem menu icon bitmap is square, so it uses the height of 
the bitmap bar to determine the width of the system 
menu icon bitmap within the bitmap bar. The code next 
creates a memory device context to hold the new bitmap, 
copies that part of the bitmap bar beyond the system 
menu icon bitmap to the same position in the new bit¬ 
map, and then copies the custom system menu icon bit¬ 
map to the beginning of the new bitmap. 

i use StretchBltO, rather than BitBltO, to copy the cus¬ 
tom system menu icon bitmap in an attempt to allow for 
the different bitmap sizes exported by device drivers of 
varying resolution. Stretching a bitmap larger results in a 
grainy-looking bitmap, so if you decide to go with this 
approach you may wish to modify the code to pick the 
most acceptable bitmap from an assortment of custom bit¬ 
map resources. Figure 3 shows a custom copy of the bit¬ 
map bar containing a custom system menu icon bitmap. 

After the initialization is complete, UinMainO creates a 
window to show the custom system menu icon. The win¬ 
dow procedure, LuhlndProcO, substitutes the custom bitmap 
bar in USER'S memory device context when it receives a 
mjCPAIHT or mjCACTIVATE message. 

As already described, DefUindowProcO 
is called to perform the non-client 
painting, and the original bitmap bar 
is restored to USER'S memory device 
context. Figure 4 shows the resulting 
window with a custom system menu 
icon. 

There is a discrepancy between 
your observation of the system menu 
icon bitmap's resource ID and that 
reported by windows, h. The constant 
0BM_CL0SE is //define' d to be 32754. 

Andrew Schulman's resdump.exe utility, 
available on the Undocumented Win¬ 
dows companion disk (Addison- 
Wesiey, 1992) or bundled with the 
Windows Source disassembly pre¬ 
processor for V Communications 
Sourcer disassembler, shows all bit¬ 
maps in vga.drv to have resource IDs 
in the range 32734 to 32767, inclu¬ 
sive. 

As for replacing bitmap 32754 in 
vga.drv with your custom bitmap, you 
could do this with Borland's Resource 
Workshop. But this would affect all 
windows, and would be difficult to 
distribute (there are many video driv¬ 
ers available, and it is likely that 
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How can you save up to 75% 
on your CompuServe bill? 



Service Bureau Communication Software for Windows 

Speed*E*Com is a GUI based communications package. It 
allows the user to create messages, mark files for download 
and respond to previous mail all off-line. A minimum of 
on-line time and long distance charges are incurred. Real 
time dollar/time counter displays your charges. Full 
encription capabilities on all E-Mail for maximum security. 



MICROSOFT.. - 

WINDOWS,. If runs with 
comfkttble NetWare 


■ftiPC 


Multimedia PC 



Available 
on 3-1/2 " 
or CD-ROM 


For more information call: 

(314) 334-6317 or FAX (314) 334-0794 

Buzzwords International, Inc. ■ 7637 County Road 621 • Cape Girardeau, MO 63701 


Listing 6 launch.c — Source for Windows 
application launch program 


HWNO hwndT; 

/* Fill the style list with style names. */ 
hwndT * GetDlgltemthwnd, didStyle); 
for (isz = 0; isz < cszStyle; isz++) 
SendMessageihwndT, CB_ADDSTRING, 0, 

(LPARAMK LPSTR) rgszStyl e[1 sz]) ; 
SendMessagethwndT. CB.SETCURSEL, SWJORMAL, 0); 
) 

return TRUE; 

case WMJOMMAND: 
switch (wParam) 

( 

default: 

break; 

case IDOK: 

{ 

char szBuf[cchCommandMax + 1]; 

GetDlgItemText(hwnd. didFileName. szBuf, 
sizeof szBuf); 

WinExec(szBuf, (UINT)$endDlgItemMessage( 
hwnd. didStyle, CBJETCURSEL, 0, 0)); 

} 

return TRUE; 

case IDCANCEL: 

EndDialog<hwnd. 0): 
return TRUE; 

) 

break; 

) 

return FALSE; 

) 

/* End of File */ 
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Listing 7 launch.rc — dialog resource for 
application launcher 



/* launch.rc */ 
/* -- Dialog resource for application launcher. */ 
/*****************************************************/ 


#include <windows.h> 
include "launch.h" 

dlgLaunch DIALOG 6. 18. 166, 54 
STYLE DS.MODALFRAME I WS_P0PUP I WSJISIBLE | 
WSJAPTION I WSJYSMENU 
CAPTION "Application Launcher" 

FONT 8, "MS Sans Serif" 


BEGIN 

RTEXT 

"AName:". -1. 2, 4. 26. 8 

EDITTEXT 

didFileName, 32. 2. 132. 12. 

DEFPUSHBUTTON 

ES.AUTOHSCROLL 

"ALaunch", IDOK. 2. 38. 76. 14 

PUSHBUTTON 

"ADone", IDCANCEL, 88. 38. 76. 14 

RTEXT 

"AStyle:". 106. 2. 22. 26. 8 

C0MB0B0X 

didStyle. 32. 20. 132. 112. 

END 

CBS DROPDOWNLIST 


some, if not all, vendors would object to redistribution of 
their drivers). 



Borland C++ v3.1 
Microsoft C/C++ v8.0 
Symantec C++ v6.0 


Q Is there any way to invoke an application from another 
Windows application without the user's being aware 
that the second program has been invoked? 

John Buchanan 
jbuchana@peruvian.cs.utah.edu 


Your Bug 
Tracking 
System is 
Obsolete 


a cowuni 

LANGUAGE 

VVJNixMs tisisSSSSSBBr ^ 

(i aiim »« i wpzwmmmnr’ 

FREE DEMO DISK! 

Call: 800-695-2303 


Discover Defect Control 
System for Windows, 
Version 2.0 


More than a bug tracking tool. DCS 
is an award-winning defect manag¬ 
er that helps your entire team 
deliver quality software on time. 


"DCS Is easy to use and performs 
a great service." Software Development 
Can you say this about your present 
system? DCS is easy to customize 
so it won't change the way you 
work. Built-in messaging notifies 
you of new or changed defects, and 
dedicated query and report tools 
put critical information at your 
fingertips. 


"The first off-the-shelf Windows 
alternative to in-house 



developed systems." PC Week 
You don't have time 
to maintain a tracking 
system that's obso¬ 
lete. Discover how 
DCS can modernize 
your development 
efforts and make 
defect management 
easy. 


SOFTWAREi 3 Cel W 

The Leader in Defect Management 

The Software Edge Inc. 

5526 N. Academy Blvd., Colorado Springs, CO 80918 
Telephone: (719) 598-3713 Fax: (719) 598-3970 
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Application Launcher 

Name: 

1 





Style: 

SW NORMAL 

*! 


Launch 


JPLone 


Figure 5 Sample Windows application launch 
program 


A I assume you mean without the user seeing a win¬ 
dow appear from the invoked executable. In general, 
the answer is no, since the behavior of the launched ap¬ 
plication is completely up to the application. But a typical 
"well-behaved" application possessing a main window will 
pass the nCmdShou parameter (the fourth parameter passed 
to UinMainO) to ShowUindowO after the main window is cre¬ 
ated. You can control the initial appearance of applica¬ 
tions written this way. The trick lies in the second parame¬ 
ter passed to UinExecO. This will be the value passed to 
UinMainO via the nCmdShow parameter. In fact, if you invoke 
notepad, exe with the value SU_HIDE for the second parame¬ 
ter, you will create an instance of notepad.exe whose main 
window is hidden. Not only will users not be aware of the 
program, they will not be able to Alt-Tab to it, or see it in 
the Task Manager program list. Passing the SU_SHOUMIN- 
N0ACTIVE value is not quite so severe. It will launch the 
specified program as an icon, and will not change the cur¬ 
rent active window, as many of the other SU_xxx values 
do. 

launch.h (Listing 5), launch, c (Listing 6), and launch, rc 
(Listing 7) implement a program that lets you launch a 
Windows application using any of the 10 possible SU_xxx 
values. The program is implemented as a single modal 
dialog (see Figure 5). Using a modal dialog for an applica¬ 
tion's main window removes the necessity for registering 
a class, creating a main window, and entering a message 
loop. When the modal dialog returns, the program termi¬ 
nates. Modality is really a moot concept when an applica¬ 
tion possesses no other window. 

When the user presses the "Launch" push button, the 
dialog procedure extracts the contents of its edit control, 
which is used as the command line to UinExecO. The style 
is extracted from a drop-down listbox and is supplied as 
the second parameter. One warning about creating invis¬ 
ible programs. They are very hard to get rid of! Since you 
can't see them in the Task Manager's task list, and you 
can't activate them, they cannot normally be killed 
through the mouse or keyboard interface. However, there 
is a handy little sample application distributed with the 
Microsoft SDK, thsample.exe, that, among other things, al¬ 
lows you to walk the list of tasks (regardless of whether they 
have a visible window) and terminate any you desire. □ 
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Dynamic-Link Device Drivers 
for DOS 



Thomas W. Nelson 


DOS device drivers let you isolate hardware-dependent aspects of your code 
in separate modules that you can distribute and update independently of your 
main application. Despite these advantages, certain restrictions inherent in DOS 
drivers limit their flexibility: 

• The user has to modify config.sys and reboot to use a new device driver. 

• The device driver is always present, using precious conventional memory, 
even when the application that uses the driver is not running. 

• The code inside the DOS device driver has to follow strict rules and cannot, 
for example, call I NT 21h functions. 

In this article, I will show you how to create ‘dynamic-link device drivers' for 
DOS that overcome these restrictions. Dynamic-link device drivers are similar to 
Windows and OS/2 DLLs. I supply functions that let you load a driver (like 
Windows' LoadLibraryO), obtain the address of a specific function in a library 
(like Windows' GetProcAddressO) so that you can call it, and free up a library 
(and the memory it occupies) when you no longer need it (like Windows' 
FreeLibraryO). The ability to load and call device driver code at runtime opens 
some possibilities not available with a standard DOS device driver. 


Tom Nelson is an independent author and programmer residing at 5004 W. Mt. Hope 
Rd„ Lansing, Ml 48917. His current interests include DOSA/Vindows systems program¬ 
ming and OOP design in C++. 
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Advantages of Dynamic Linking 

Let's say you develop and market serial communica¬ 
tion software. Your software may want to support differ¬ 
ent serial devices (standard versus multiport boards, for 
example), different file transfer protocols (XMODEM versus 
Kermit, for example), and different terminal emulations 
(such as VT-100 and ANSI). Linked into a single .exe, all 
this functionality could result in something huge. However, 
your program probably only uses one serial device type, 
one file transfer protocol, and one terminal emulation at a 
time. If you structured those parts of the code as device 
drivers, you could dynamically load only the ones you 
need at runtime and avoid wasting memory for those that 


Listing 1 drvhdr.asm — Header code for 
dynamic-link device drivers 


; Author: T.W. Nelson 

; Assembler: BORLAND 

: Assembly options: 

; Version: 2.00 

: Notes: 

; Module must be 1st in link order. Entry 
; point into the module must be at offset 0 
; in the overlay segment. 

; Source code Copyright (c) 1993 T.W. Nelson. May 
; be used only with appropriate acknowledgement of 
; copyright. 

.model large,C ;far code, far data 
.stack ;dummy stack used only for 

imarking end of memory 

.data 

;These data made available to user init function 
;to determine module memory size requirements ... 
Jieapseg dw 0 ;seg addr, start of heap 

Joadseg dw 0 ;seg addr, start of module 

public C Jieapseg 

public C Joadseg 

;0utlay of driver module function export table . 

expTab struc 

funcname dd ? ; ->asciiz name of driver function 

pfun dd ? ; -> driver function 

expTab ends 

;This object required and must be defined 

;in the driver extension module . 

extrn C fTable:DATAPTR ;struct expTab[] 

.code 


: int far _hdr_start(struct ModuleDescriptor *mDesc) 

: NOTE: no code must preceed ’Jidr_start’ entry point.. 
_hdr_start proc far uses si di ds, mDesc:dword 

;. Load local data segment . 

mov ax.Odata 

mov ds.ax 

;. Fill in data for user init . 

mov ax,seg STACK ;end of memory (high) 
mov Jieapseg,ax ;get beg heap 

mov ax.cs ;beg memory (low) 

mov Joadseg,ax ;== start of overlay 

;. Call user initialization proc. User initO 

; must be the 1st function listed in the module 

; export table . 

les bx.mDesc 

mov di,offset fTable 

mov dx.seg fTable 

push es 

push bx ;arg for InitO 

mov es.dx 

call es:[di].pfun ;init(mDesc *) 

pop bx ;fix stack 

pop es ;(C calls only) .... 

ret ;return InitO status In ax 

_hdr_start endp 
end 

; End of File 


aren't being used. This scheme also lets you produce and 
ship drivers for new devices (or protocols, or emulations) 
without having to ship a completely new copy of the 
main program and lets users also avoid using disk space 
for modules they don't plan to use. 

As another example, suppose your program requires a 
standard DOS driver such as ansi.sys. You could produce 
your own act-alike version of it and put it into a dynamic- 
link device driver. This saves the user (or your installation 
software) from having to modify config.sys. If ansi.sys is 
actually present, your program could still interface with it, 
but would not require that it be installed. Since your cus¬ 
tom ANSI driver dispenses with the overhead of DOS INT 
21h and (some) BIOS video service calls, you could realize 
a substantial speed improvement by interfacing with the 
video hardware directly. Further, you would also sacrifice 
none of the portability you otherwise gain by using the 
ansi.sys driver: different operating environments and/or 
hardware would simply require another version of the 
driver, not a new version of the program. The base pro¬ 
gram might only need re- compiling. 

Another advantage of dynamic-link DOS device drivers 
is that they are free to make DOS INT 21h calls. By com¬ 
parison, since DOS is not reentrant, standard DOS device 
drivers cannot make INT 21h calls without corrupting 
DOS's internal stack. This non-reentrant restriction makes 
standard DOS device drivers notoriously difficult to test 
and debug. The usual software debugger is problematic in 


Listing 2 drv.h — Common header file for 
dynamic-link device drivers 


/* . 

* Source code Copyright (c) 1993 T.W. Nelson. May 

* be used only with appropriate acknowledgement of 

* copyright. 

* */ 

#ifndef_DRV_H 

//define_DRV_H 

typedef int flag_t; 

//Driver function type. All driver functions must 
//load register DS on entry, in order to address local 
//data. Calls to driver functions are always ’far’ 
//calls. Driver module must also be able to address 
//stack-based variables, since module’s SS:SP always 

//points to client’s stack. 

// 

^define DRVFUNC flag_t Joadds far 

// This MUST be set up by driver modules as a 
// function export and jump table. The driver 
// initialization procedure must also be listed as 
// the 1st function in the table. Table must also 
// be terminated by a NULL member.... 

// 

struct expTab { 

char *name; //driver function name 

DRVFUNC (*pfun)(); //-> driver function 
): 

//define M0D_EXT ".DRV" //.ext for all drivers 

^define MAXJAME 15 

// This tracks loaded driver extension modules. 

// Requested module size and pointer to function 
// export table MUST be returned by user- 
// supplied initializer.... 

// 

struct ModuleDescriptor { 

unsigned mseg; //module segment selector 
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this situation, because it also may need to make INT 21h 
calls. 

Overview 

The basic idea for implementing dynamic-link device 
drivers is to create a separate (non-executable) .exe mod¬ 
ule for each driver. The application can then allocate 
memory for the driver module, load it into memory and 
initialize it for use, then call the functions residing in the 
module. Windows does most of this for you automatically, 
but your DOS program needs to act as its own operating 
system in this instance. A few of the problems you have 
to solve include: 

• Non-relative address references in the .exe must be 
fixed up so they refer to the correct address. 

• Given a symbolic function name, such as "Printstring", 
the application must be able to locate the address of 
the corresponding function in the driver .exe. 

• Like Windows DLL functions, dynamic-link device driver 
functions cannot assume that the DS register points to 
the driver's data segment when the application calls 
them. 

You can see how I solved these problems by looking at 
how I construct an application that uses a dynamic-link 
device driver. 
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Requires only 6KB of base memory 
Implemented as 100% Windows DLL 
(not a TSR) 

■ All applications are both client and server 

■ Works concurrently with NetWare, LAN Manager, 
Vines etc. 

■ Up to 128 simultaneous sessions 


Each driver contains a global table (which you must 
maintain manually) of the names and addresses of ex¬ 
ported functions. This function export table lets your appli¬ 
cation know what driver functions are publicly available 
and provides applications with the means to locate the 


Listing 2 continued 


unsigned modsize; //module size, pgraphs 

struct expTab *fTab: //-> func export table 
DRVFUNC (*exit_f)(vo1d); //-> on-exit function 
void *pblock; //-> malloc'ed block 

void *args; //-> module setup argument(s) 

char *id; //-> module id string 

int vjnajor; //module version numbers 

Int v_.nl nor; 

char mname[MAX_NAME]; //module name, less .ext 

}; 

DRVFUNC driver_init(struct ModuleDescriptor *); 

// Driver extension module manager prototypes 

// and return values . 

flag_t DrvLoadModule ( char *modname. 

unsigned *handle, void *args ); 
flag_t DrvGetProcAddr( unsigned handle. 

char *procname, DRVFUNC (**ppfn)0); 
flag_t DrvGetModID( unsigned handle. 

Int *major, int *minor, char *idstr ); 
flag_t DrvFreeModule( unsigned handle ); 
flag_t DrvGetModName( unsigned handle, char **name ); 
flag_t DrvGetModHandle( char *mname. unsigned *handle ); 


♦define TRUE 0 

♦define ERR_MOD_LIMIT -1 
♦define ERR_MOD_ACCESS -2 
♦define ERR_N0_MEM -3 
♦define ERR_BAD_LOAD -4 
♦define ERR_INIT_FAIL -5 
♦define ERR_BAD_HANDLE -6 
♦define ERR_BAD_LINK -7 
♦define ERR_MOD_NAME -8 

♦endif // _DRV_H 

/* End of File */ 


//OK 

//Too many modules loaded 
//Can't find driver module 
//Out of memory for load 
//DOS Exec overlay error 
//module init failure 
//Bad handle passed 
//Can’t find function 
//Can’t match module name 


Developer Tools: 

Windows Socket API 
Berkeley 4.3 Socket API 
ONC RPC/XDR 
WinSNMP API 


Applications: 

TELNET (VT100,VT220),TN3270, 
FTP, TFTP, SMTP Mail, POP, News 
Reader, SNMP, PING, BIND,Finger, 
Whois, Statistics, and Custom 


Extensible SNMP Agent 

■ Includes MIBII, Workstation,Windows and 
DOS agents 

■ Dynamic registration of multipleagents, managers, 
and proxies 

■ WinSNMP API developers kit available 

■ Compatible with any SNMP manager 

■ Free with NEWT, Chameleon, and ChameleorhVFS 

NFS Client /Server 

■ Network drives are mounted from within Windows 

■ Network printing in the background 

■ Up to 24 network drives 

■ Requires only 6KB of base memory 

■ Included in ChameleonATS 

For overnight delivery call: 

0§Nei Manage" 

(408) 973-7171 


20823 Stevens Creek Blvd., Cupertino, CA 95014 USA 
Fax (408) 257-6405 
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Listing 3 makefile — Sample makefile for dynamic-link device driver 


tasm S(ASSEMBLE) $* 

# 

all: demo.exe display.drv 

# Borland-style makefile for DOS 


# Dynamic link device drivers 

drvman.obj: drvman.c drv.h 


testbase.obj: testbase.c drv.h 

MODEL = 1 #use large only 


STARTUP = \lib\c0$(MODEL) 

drvhdr.obj: drvhdr.asm 

LIBS = \1 i b\c$(MODEL) 


LINK = /m /s /v 

display.obj: display.c drv.h 

COMPILE = -w -c -v 


ASSEMBLE = /*+- /mx 

display.drv: drvhdr.obj display.obj 


tlink $ ( LINK) drvhdr display.display.drv,,$(LIBS) 

.obj.exe: 


tlink t(LINK) S(STARTUP) $*,**,.S(LIBS) 

demo.exe: drvman.obj testbase.obj 


tlink $ (LINK) J(STARTUP) testbase drvman,\ 

.c.obj: 

demo.exe,, $( LIBS) 

tcc $(COMPILE) -m$(M0DEL) $* 



# . End of File . 

.asm.obj: 



functions and perform the dynamic link. Functions placed 
in this table must be declared with the Joadds keyword so 
the compiler will generate function prologue code that 
loads the correct value for the data segment register. The 
first function in the table has to be a special startup func¬ 
tion that gets called when the application loads the library 
(like Windows DLL's LibMainO function). I also require you 
to link the driver with special startup code instead of the 
compiler's default runtime startup code. This startup code 
calls the driver's initialization function, pointed to by the 
first entry in the export table. 


NEW! Image SDK Plus 

NEW Image SDK Plus now reads, writes & prints TIFF, 
PCX, DCX, BMP, DIB, CLP, TGA, GIF, WMF & 

ColorFax Format. Unique functions available only from 
Black Ice Software such as: 

• 1 degree or 90 degree increment rotation 

• skewing images 

• dithering- 24, 8, 4, 2 bit 

• antialiase conversion 

• color scaling & color interpolation 

• digitze ASCII text 

$299.95 Royalty Free 
NEW VERSION 5.0 

TIFF SDK V5.-Decompress CCITT G4 in under 2 
Seconds !Supports CCITT G3 2D, ID & G4, CALS, IBM's 
MMR IOCA, LZW & Packbit. Scaling, multiple images 
supported. Read & write 24 bit images, decompress E or 
D size images from memory, from offset or every repaint. 
Image editing functions include invert, rotate, flip, display 
& print. Call for BenchmarkTest Results. Over 60 functions. 
$299.95 Royalty 

• Image SDK Plus with VBX ONLY $199! 

• All SDK's are compatible with VB, Actor, 

Borland C++, MS Excel, SQL Windows 

• Source code "Royalty Free" 

• FREE ColorFax for Windows 

• Competitive Upgrades for ONLY $99! 

Black Ice Software, Inc. *113 Rt.122 I Amherst, NH 03031 

Tel (603) 673-1019 ♦ Fax (603) 672-4112 _ 
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On the application side, you must link with a set of 
functions that handle loading and managing dynamic-link 
device drivers. When you call DrvLoadModuleO to load a 
driver, it allocates memory and uses the DOS EXEC func¬ 
tion (INT 21H, function 4Bh) to load the driver .exe into 
memory, which handles the relocation problem. The 
driver's initialization function returns the address of its 
function export table to DrvLoadModuleO ; function DrvGet- 
ProcAddressO then uses this address to locate a particular 
function address by name. When you no longer need the 
driver, DrvFreeModuleO can remove it and free up the 
memory it occupied. 

The Device Driver Header 

drvhdr.asm (Listing 1) contains the startup code that you 
must link with your dynamic-link driver module in place of 
the compiler's normal startup sequence. The base applcia- 
tion executes this code - a short assembly language func¬ 
tion called _hdr_start() - immediately after it successfully 
loads the module into memory. The function's main pur¬ 
pose is to set up the runtime environment for the driver 
module and call the user-supplied module initialization 
function. 

When your application calls DrvLoadModuleO to load the 
driver, DrvLoadModuleO will allocate memory, load the 
driver into it, and then call _hdr_start() (the name here is 
actually irrelevant, since DrvLoadModuleO merely casts the 
address of the first byte of the module into a function 
pointer and makes the call indirectly via that pointer). 
DrvLoadModuleO passes _hdr_start() a pointer to an object 
of type ModuleDescriptor (Listing 2). _hdr_start() sets two 
variables, Joadseg and _heapseg, which correspond, respec¬ 
tively, to the beginning and end of the module's memory. 
Joadseg contains the segment address at which the mod¬ 
ule was loaded and where execution begins. _heapseg actu¬ 
ally points to what would have been the beginning of the 
driver's stack if it were a normal .exe, since that marks the 
end of the module's data. 

drvhdr.asm references a global object of type struct 
expTab (Listing 2). You must define an object of this type 
named fTable within the driver module. fTable contains 
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the names and addresses of the functions the driver ex¬ 
ports to client applications. After initializing Joadseg and 
_heapseg, _hdr_start() locates the first function in fTable 
(presumed to be the initialization function for your driver) 
and calls it, passing along the pointer to the ModuleDescrip- 
tor structure that DrvLoadModuleO passed in. 

Your driver's initialization function (the function you 
place first in fTable) can perform whatever initialization 
you like. At a minimum, though, it must initialize the mod- 


size and fTab fields in the ModuleDescriptor structure. Figure 
1 shows an example initialization function. 

The initialization function must set the modsize field to 
indicate the total size, in paragraphs, of the device driver. 
In the simplest case, you could just set modsize equal to 
the difference between the starting and ending segment 
addresses i_heapseg - Joadsetf). As discussed later, though, 
you may need a block of memory to implement a local 
memory management scheme (your driver won't be able 


Listing 4 drvman.c — Source code for managing drivers 

/* . 

* Author: T.W. Nelson 

assertC strlenC modname ) < MAX NAME ); 

* Compiler: BORLAND 

strcpyC pmDesc->mname, modname ); 

* Compile options: Large model only 

* Version: 1.00 

pmDesc->args = args; //setup arguments 

* 

//Access DRVPATH in environment and build pathname 

* Source code Copyright (c) 1992 T.W. Nelson. May 

//string for extension module. Use CWD by default 

* be used only with appropriate acknowledgement of 

//if no DRVPATH variable exists. 

* copyright. 

drvpath = getenv("DRVPATH"); 

* . */ 

fnmerge( EXTname, drvpath ? drvpath 


: getcwd(cwd, MAXPATH), modname. MOD EXT); 

^include <stdio.h> 

//Verify that driver extension module exists .... 

^include <stdlib.h> 

if( access( EXTname, 0 ) != 0 ) 

^include <string.h> 

return ERR MOD ACCESS; 

include <mem.h> 

//Attempt to allocate up to a segment (64k bytes) 

#include <dos.h> 

//for the module. Calling allocmemO here always 

^include <1o.h> 

//fails . 

#include <dir.h> 

if( (rval = allocmem( 0xffff, ipseg)) > SEG PARAS ) 

include <assert.h> 

rval = SEG PARAS; 

#include "drv.h" 

if((pmblock = malloc( rval « 4 )) == 0) 

#define MAX MODULES 30 

return ERR NO MEM; //out of memory 

#define SEG_PARAS 0x0fff //digraphs in a segment 

//Normalize mallocO return and adjust module 

static struct ModuleDescriptor mDesc[MAX_MODULES]: 

//load segment to next highest pgraph boundary ... 

static int NumModules = 0: //^modules loaded 

rval = FP_0FF( pmblock ); 

pseg = FP_SEG( pmbl ock ) + (rval » 4) + 

//parameter block for DOS int 21/4bh, load overlay .... 
struct dos exec { 

((rval & 0x000f) ? 1 : 0); 

unsigned seg; 

//Load driver module as an overlay . 

unsigned relocator; 

}; 

parms.seg = pseg; //load parms block 

parms.relocator = pseg; 

sregs.es = FP_SEG( (void *) &parms ); 

flag_t DrvLoadModule ( char *modname, 

regs.x.bx = FP_0FF( (void *) &parms ); 

unsigned *handle, void *args ) 

sregs.ds = FP SEG( (void *) EXTname ); 

i 

regs.x.dx = FP 0FF( (void *) EXTname ); 

/* Load and initialize the requested module and 

regs.x.ax = 0x4b03; //DOS load overlay 

* assign module handle. Return TRUE on success 

intdosx( iregs, iregs, fcsregs ); 

* (and also if module was previously loaded). */ 

if( regs.x.cflag ) { 


free( pmbl ock ); 

size_t pseg, rval; 
void *pmblock; 

return ERR BAD LOAD; 

1 

register int i; 

OvEntry = MK_FP(pseg, 0); //set up entry point 

union REGS regs: 

rval = OvEntry( pmDesc ); //xfer to overlay 

struct SREGS sregs; 

if( rval ) { 

struct dos exec parms; 

free( pmblock ); 

int (*0vEntry)( struct ModuleDescriptor * ); 
struct ModuleDescriptor *pmDesc; 

return ERR INIT FAIL; 

} 

char EXTnameCMAXPATH]. cwd[MAXPATH], *drvpath; 

//Shrink mallocated block. Add 1 to request size 
//to adjust for normalizing. This code assumes 

//Check load status of module ... 

//request size is always less than the size of 

if( DrvGetModHandle( modname, handle) == TRUE ) 

//the original malloced block. 

return TRUE; //already loaded 

pmblock = realloc(pmblock,(pmDesc->modsize + 1) « 4); 

//Update module descriptor array . 

♦handle = -1; //pre-set for error return 

pmDesc->mseg = pseg; //indicate module in use 
pmDesc->pblock = pmblock; //use later for freeO 

//Find open slot in mDesc[] array . 

++NumModules; //keep running total 

for( i = 0: i < MAX MODULES ; 1 ++ ) { 

♦handle = i; //assign handle 

if( mDescti].mseg == 0 ) 

return TRUE; 

break; //found slot . 

i 

i 

flag t DrvGetProcAddrl unsigned handle. 

if( i >= MAX.MODULES ) 

char *procname, DRVFUNC (**ppfn)0) 

return ERR_MOD_LIMIT; 

{ 

/* Given module handle and ASCIIZ procedure name. 

pmDesc = &mDesc[i]; //point to open slot 

* return a pointer to indicated function in the 

* driver module. Return NULL pointer if function 

//reset all data items to be assigned by 

* can’t be found. Search is case-sensitive. 

//user driver initializer function . 

*/ 

pmDesc->modsize = 0: 

struct expTab *tabp; 

pmDesc->fTab = 0; 

int i; 

pmDesc->exit f = 0; 

if( handle >= MAX MODULES II 

pmDesc->id = 0; 

mDesc[handle].mseg == 0 ) { 

pmDesc->v_major = -1; 

♦ppfn = 0L; //return NULL -> 

pmDesc->v_minor = -1; 

return ERR_BAD_HANDLE; 
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Listing 4 continued 


} 

tabp = mDesc[handle].fTab: 
for( i = 0; tabp[i].name ; i++ ) { 

if( strcmp( procname, tabpCi].name ) == 0 ) { 
*ppfn = tabpCi].pfun; 
return TRUE; 

} 

} 

*ppfn = 0L; //return NULL -> 

return ERR_BAD_LINK; //no match found 


flag_t DrvGetModID( unsigned handle, 

int *major, int *minor, char *idstr ) 

{ 

//Return ID information for an active module, 
struct ModuleDescriptor *pmd; 
if( handle >= MAX_MODULES II 

mDesc[handle].mseg == 0 ) { 

return ERR_BAD_HANDLE; 

} 

pmd = &mDesc[handle]; 
idstr = pmd->id; 

*major = pmd->v_major; 

♦minor = pmd->v_minor; 
return TRUE; 


flag_t DrvFreeModule(unsigned handle) 

t 

/* Given module handle, release module and free 

* associated DOS memory. 

*/ 

struct ModuleDescriptor *pmd; 
if( handle >= MAX_MODULES II mDesc[handle].mseg == 0 ) 
return ERR_BAD_HANDLE; 
pmd = &mDesc[handl e]; 
if( pmd->exit_f ) 

(*pmd->exit_f)(); //do on-exit duties 
freet pmd->pblock ); 

pmd->mseg = 0; //indicate inactive 

pmd->pblock = NULL; 
pmd->mname[0] = ’\0’; 

--NumModules; //keep count 

return TRUE; 

} 

flag_t DrvGetModNamet unsigned handle, char **name ) 

{ 

/* Given module handle, return ASCIIZ name of 

* active extension module, NULL if handle is 

* invalid or if module not active. 

*/ 

if( handle >= MAX_MODULES II 

mDesc[handle].mseg == 0 ) { 

*name = NULL; 
return ERR_BAD_HANDLE; 

} 

*name = mDesc[handle].mname; 
return TRUE; 


flag_t DrvGetModHandle( char *mname, unsigned *handle) 
{ 

/* Given ASCIIZ name of active driver module, 

* return module handle. Returns error if module 

* can’t be located. Search is case sensitive. 

*/ 

register int i; 

fort i =0; i < MAX_MODULE$ ; i++ ) { 

if( strcmpt mname, mDesc[i].mname ) == 0 ) { 
ift mDesc[i].mseg != 0 ) { 

‘handle = i; 
return TRUE; 

} 

} 

} 

return ERR_MOD_NAME; 

} 

/* End of File */ 


to just call mallocO and freeO). If so, just add the amount 
of memory (in paragraphs) that you need. You can form a 
far pointer to that block with the expression: 

MK_FP(_heapseg,0) 

Setting the fTab field to point to the local table of function 
names and addresses gives the calling application access 
to the driver functions you want to export. The ModuleDe- 
scriptor structure optionally lets you specify a function to 
be called when the module is unloaded (analogous to 
Windows DLL's UEP() function); just set the exit_f field to 
the address of the desired shutdown function. 

Other optional fields in the Modul eDescri ptor structure 
include a major and minor version number ( vjnajor and 
vjninor) and a pointer to a string identifier that names the 
device (id). You might want to use the identifier string to 
confirm that you have loaded the correct module; you 
could use the version numbers to handle backward com¬ 
patibility problems. If you don't have a use for these 
fields, you can leave them NULL. 

Creating the Device Driver 

As mentioned earlier, when you create your dynamic- 
link DOS device driver, you have to create a global table 
of type struct expTab that contains the names and ad¬ 
dresses of the device driver functions you are exporting. 
The last entry must be NULL to serve as a marker for the 
code that searches the table. The first entry must point to 
your initialization function, which takes an argument that 
points to a Modul eDescri ptor structure. This structure is de¬ 
fined in drv.h (Listing 2), so you will want to # include that 
in your driver code. You need not supply a name for that 
function, since _hdr_start() merely calls the first function 
in the table. 

Ail of the driver functions you export must be declared 
with the Joadds modifier, so the compiler will generate 
code to load the proper value for the data segment regis¬ 
ter. In drv.h (Listing 2) I define a macro called DRVTYPE that 
I use to declare exported functions. It also inserts the far 
keyword, though that is not strictly necessary since my 
scheme requires both the application and the driver to be 
compiled with the large or huge memory model. 

When the code for the device driver is complete, you 
compile it as a large or huge memory model program and 
link with drvhdr.obj instead of the normal startup code. 
drvhdr.obj must come first in the link order so that its 
code will reside at offset zero, where DrvLoadModuleO ex¬ 
pects to find it. Listing B shows a sample Borland makefile 
for the complete device driver example on the code disk. 

Accessing the Device Driver 

To allow your application to access the device driver, 
include the declarations in drv.h (Listing 2) and compile 
(large or huge memory model) and link with the functions 
in drvman.c (Listing 4). The manager functions mimic the 
action of similarly named OS/2 system functions that 
manage runtime DLL modules. All these functions return 
integer values. 
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DrvLoadModuleO loads and initializes the module whose 
name you specify as an argument. If successful, it returns 
an integer handle that refers to the loaded driver module 
when calling other manager functions. The handle is an 
index into an array of ModuleDescriptor structures. Each 
element of the mDesc[] array contains data referring to an 
active driver module. The final argument to DrvLoad¬ 
ModuleO is a pointer to an argument to be passed to the 
driver's initializer function. You can use this to pass setup 
data, such as the size of heap to be allocated by the 
driver. Since the argument type is unspecified (i.e., void *), 
it can point to any data type or structure known to both 
your client and the driver. 

Once called, DrvLoadModuleO determines if the module 
has already been loaded by calling DrvGetModHandleO. This 
routine checks the module name against the names of 
modules in the mDesc[] array (modules already loaded) 
and returns the handle if it found a match. Otherwise, 
DrvLoadModuleO continues by attempting to find an avail¬ 
able slot in the mDesc[] array. A slot is considered open if 
mDesc.mseg (the module's load segment) equals 0. If no 
slots are open, DrvLoadModuleO returns an error. 

By default, DrvLoadModuleO assumes driver modules are 
located in the current working directory. The function also 
checks for the presence of the DRVPATH environment vari¬ 
able, which specifies an alternate path for device drivers. 
However, setting up an environment variable involves ed¬ 
iting autoexec.bat, which you might want to avoid. Instead, 
you might place all driver modules in a location specified 


by the DOS PATH variable, or in a subdirectory whose 
name is hardwired in your program. An installation pro¬ 
gram could perform both of these operations without user 
intervention. Using accessO, DrvLoadModuleO attempts to 
verify if a file of the specified name actually exists before 
proceeding. The code assumes that all dynamic-link device 
driver modules have the extension M0D_EXT, which is a 
macro defined to be ".DRV' in drv.h (Listing 2). 

After locating the desired driver's file, DrvLoadModuleO al¬ 
locates the memory necessary to load the module as an 
overlay, using the DOS EXEC function (4Bh). This strategy is 
somewhat troublesome in view of the limitations imposed 
by mallocO. An earlier version of my code used allocmemO, 
which I prefer here because it works naturally with the 
segment addresses and paragraphs needed by DOS EXEC, 
instead of far pointers and bytes as required by mallocO. 
allocmemO is an interface to the DOS memory allocator 
(48h) and (in the Borland standard library) can't co-exist 
with mallocO. In large model programs, mallocO uses all 
available DOS memory and thus competes with allocmemO 
for the same space. Since the rest of your base application 
will almost certainly use mallocO to some extent, using 
allocmemO here is prohibited. 

To determine the largest amount of memory available 
for loading a module, DrvLoadModuleO calls allocmemO, re¬ 
questing 64Kb paragraphs. This call always fails (a result 
that doesn't conflict with mallocO) and returns the size of 
the largest memory block in paragraphs. DrvLoadModuleO 
then calls mallocO, requesting up to 0xfff0 bytes. Using 
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mallocO also imposes a limit of 0xfff0 bytes on the size of 
driver modules, which is probably large enough for most 
applications. 


Figure 1 Sample driver initialization function 


DRVFUNC driver_init( struct ModuleDescriptor *mDesc ) 
{ 

extern unsigned _heapseg; //from drvhdr.asm 
extern unsigned Joadseg; 
char id[] = "DEVICENAME"; 

/* Compute how much memory is to be used for the 

* module (in paragraphs), set module version and 

* ID certification, set a pointer to the function 

* export table, and perform other initialization 

* tasks such as hardware detection. User may 

* allocate memory as needed after _heapseg for a 

* heap or other workspace. 

*/ 

unsigned as_needed = 0; 
mDesc->modsize = 

(_heapseg + as_needed) - Joadseg; 
mDesc->v_major = major; 
mDesc->v_minor = minor; 
mDesc->id = id; 
mDesc->fTab = fTable; 
mDesc->exit_f = shutdown; 
return TRUE; 



□ Request 108 on Reader Service Card □ 


mallocO returns a far pointer to the allocated memory 
block, but it may not start on a paragraph boundary, as 
required by DOS EXEC, and it may not be a normalized 
pointer (the offset may be greater than 16). To correct 
that, divide the offset portion of the address by 16 and 
add it to the segment. The remainder, always less than 
16, becomes the offset. To form the load segment, add 1 
to the segment if the offset remainder is non-zero. That 
gives you a segment that refers to the first full paragraph 
in the block returned by mallocO. 

DrvLoadModuleO uses DOS EXEC (INT 21h, function 4Bh) to 
load the driver module as an overlay. The EXEC function 
uses the load segment as the segment relocation value, 
which it applies to the contents of the overlay file. Once 
loaded, DrvLoadModuleO transfers control to the overlay 
with a far call, and starts execution at offset 0 within the 
overlay. 

Your driver initializer function must compute the 
amount of memory the module needs. It assigns this 
value (in paragraphs) to mDesc.modsize, a value that must 
be equal to or less than the size of the original block. On 
return, DrvLoadModuleO calls reallocO to return the unused 
portion of the block to the memory pool. To adjust for 
pointer normalization, it adds one paragraph to the de¬ 
sired module size and converts it to bytes for reallocO. 
DrvLoadModuleO doesn't check reallocO for an error return, 
because the adjusted size is (hopefully) always smaller 
than the original size requested from mallocO. 

After you successfully load a driver with DrvLoad¬ 
ModuleO, you can pass the resulting module handle to 
DrvGetProcAddrO to obtain a pointer to an exported func¬ 
tion within that driver. Here is a sample code fragment 
that does just that: 

DRVFUNC (*clearScrn)(int attrib); 
unsigned display_h; 

if(DrvLoadModule( "DISPLAY", 

&display_h, 0) != TRUE ) { 
printfC’Display module load failure\n"); 
return 1; 

} 

DrvGetProcAddrt displayji, "clearScrn", 

&clearScrn ); 
clearScrn(0x70); 

ANSI C lets you use a function pointer with the same syn¬ 
tax as a function call, so I did not have to type 
TcIearScm)(0x70)' to make the indirect call through the 
clearScrn function pointer. 

When you no longer need a driver module, call 
DrvFreeModuleO to remove the module from memory. For 
devices your base application uses only occasionally, re¬ 
moving the dynalink driver module saves memory for 
other purposes. If you specified a shutdown or exit func¬ 
tion in the driver's initializer function, DrvFreeModuleO calls 
that function before it deallocates the memory block with 
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free(). This would be important if, for example, your 
driver hooked an interrupt. 

Restrictions and Limitations 

As with Windows DLL modules, you're not restricted to 
using only low-level, device-dependent code in dynalink 
driver modules. A driver module could contain, for exam¬ 
ple, a string-handling library. For more complex functions 
that make frequent calls to other library functions, how¬ 
ever, this is not a good idea. For example, if you have a 
number of dynamic-link device drivers, all of which make 
calls to printfO, you would have to link printfO into 
every such module instead of only one, as in a Windows 
system. This quickly wastes a lot of memory. For these 
reasons, I restrict dynamic-link DOS device drivers to low- 
level hardware- and device-dependent code, similar to that 
found in standard DOS device drivers. 

You are free to include any libraries when linking a 
driver module, but be careful which library functions you 
call from the driver. Some may require the presence of 
data defined and initialized in the compiler's normal 
startup sequence. For example, in the demo driver (on the 
code disk), I had to define errno, which was referenced by 
a standard library function called by a driver function. 
Other functions such as mallocO require a heap and asso¬ 
ciated pointer data, while functions like strdupO make 
calls to mallocO. Although you can configure the driver to 
accommodate a heap, you'll have to code your own func¬ 
tions to interface with it. 

Another related problem concerns using standard li¬ 
brary functions that were compiled assuming DS = SS. 
This assumption is invalid for driver modules, which must 
always run on the caller's stack. This restriction also im¬ 
plies that you must be sure the base application has 
enough stack to avoid "blowing' it when you call a driver 
function. In addition, although I haven't yet tested float¬ 
ing-point code in a driver module, I would anticipate a 
number of obstacles due to some or all of these restric¬ 
tions. 

You might want to compile your device driver with 
stack checking enabled (so the compiler calls a function to 
check for stack overflow whenever a function is called). 
Stack checking within driver functions presents a potential 
hidden problem, which I avoided altogether by not using 
them, despite some obvious benefits. With the right setup, 
there's no reason why you can't utilize them. However, 
depending on the specific implementation, stack probes 
usually need an output function for printing a runtime er¬ 
ror message, a function you would need to link into the 
driver module. You might be able to replace this function 
with a simpler, customized version, one not dependent on 
pre-initialized data. 

In principle, any type of reusable, library-type code 
(such as strcpyO) could be placed in these dynalink mod¬ 
ules. Indeed, that is the practice in DLL modules for Win¬ 
dows and OS/2. In these multitasking environments, how¬ 
ever, DLL modules must support reentrant execution and 
shared data segments, as well as the ability to call func¬ 
tions residing within other DLL modules. Because of the 
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complexity implied here, I have made DOS dynalink mod¬ 
ules a one-way street. They allow calls only from the cli¬ 
ent application that loaded them and do not have access 
to functions in other modules. 

Optional Extensions 

To save memory, many standard DOS device drivers 
are written (usually in assembly language) so that DOS 
overwrites and reuses the driver's initialization code for 
the next driver to be loaded. The driver simply reports the 
last byte of active driver memory as the first byte of its 
own initialization code, which must be located at the end 
of the driver image. 

Performing a similar procedure for a dynamic-link de¬ 
vice driver appears somewhat inconvenient, especially in 
a high-level language. As the memory map in Figure 2 
shows, the compiler by default locates the module's data 
after code. Locating the initialization code at the end of 
usable memory might be accomplished by re-ordering the 
compiler's segmentation model, or writing the entire mod¬ 
ule in assembly language. Figure 3 presents a hypothetical 
memory model for a module that allows the initializer to 
drop away. You probably won't consider this issue impor¬ 
tant unless your initializer function contains a large 
amount of code. 


Figure 3 Revised layout to drop off initialization 
code 
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An alternative way of using dynamic-link device drivers 
is to restrict the driver's programmatic interface to closely 
follow the model provided by standard DOS drivers. This 
means that the driver will have only one entry point, a 
function dispatcher that routes control to driver functions 
by using a function code as an index into a jump table. 
This also means that you eliminate one step in the run¬ 
time link, the call to DrvGetProcAddrO. You would need to 
call only DrvLoadModuleO. You could modify the ModuleDe- 
scriptor definition to hold the address of the module's 
function dispatcher. The tradeoff is slightly more code to 
execute each time you call a driver function. 

A less radical modification involves changing DrvGetPro¬ 
cAddrO so that it takes the ordinal number of a driver 
function, instead of its character string name. The ordinal 
number would be an index into the function export table 
in the driver module. You could specify these ordinal num¬ 
bers with macros in an include file. 

Testing and Debugging 

Since you code a DOS dynamic-link device driver with¬ 
out any external references to a base application, you can 
test it relatively easily by recompiling and linking it as a 
standalone testbed program. Write a mainO function (in 
the driver file) that makes test calls to driver functions di¬ 
rectly. Make sure you call the driver initializer function be¬ 
fore calling any other driver function. You also need to 
define dummy Joadseg and _heapseg variables in the test¬ 
bed version. These are defined in drvhdr.asm, but don't link 
with the header code in the standalone version. Instead, 
link the compiled testbed object file with normal startup 
code and libraries. Surround the testbed code with condi¬ 
tional compilation directives that you can deactivate when 
producing a live version of the driver. 

A standalone version of the driver module closely par¬ 
allels the environment that a live version will experience 
when called by your client. A live version differs mainly in 
that SS:SP still points to the client's stack, and DS will make 
an actual change within the driver function. The test ver¬ 
sion pushes DS and Initializes' it to the same value it had 
before. You will find these differences transparent if you 
program in C, but you need to be careful if writing a mod¬ 
ule in assembly language (or inline assembly). You must 
also make certain that you allocate enough memory for 
the module. Any mistakes in this regard will not show up 
in the test version. 

Summary 

Dynamic-link device drivers offer many of the advan¬ 
tages of standard DOS drivers, but without many of their 
restrictions. The code disk (see the table of contents page 
for availability) contains a complete demonstration pro¬ 
gram and device driver that you can examine and tailor 
to your own needs. □ 
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Windows Multimedia: Part 1 
Bitmap Special Effects 

Charles Mirho 


Bitmaps are important in multimedia programming because they provide a 
means of communicating information visually. Windows offers a family of func¬ 
tions for storing and displaying bitmaps in a device-independent way, and 
these functions allow you considerable scope in manipulating visual images. A 
picture of a car, for example, is clearly more descriptive than a couple of 
paragraphs explaining the car's color, make, style, wheels, and so on, but how 
you present the picture can also affect the information content. A bitmap of a 
car that sweeps into view from left to right might make more of an impact 
than a traditional, top-to-bottom display. The left-to-right sweep implies hori¬ 
zontal motion, speed. You can squeeze more information from a bitmap by 
displaying it creatively. 

Types of Bitmap Special Effects 

The types of effects you can use to paint a bitmap on the screen are limited 
only by your imagination. You can 'crush' bitmaps from top to bottom or side 
to side, display them diagonally from any corner, spiral them from the edges in 
or the center out, fade them using blocks or colors, and 'shutter' them so that 
they appear as though viewed through an opening shutter blind. In this article I 
will look at crush and diagonal effects. 

How to Display a Bitmap 

This section briefly covers how to display a bitmap that already resides in 
memory. How the bitmap got into memory is up to you, but typically, it will be 
loaded from a disk file (the sample program on the code disk - see the table 
of contents for availability - contains code to do just this). Once the bitmap is 
in memory, the next step is to set up a device-independent header, display 
context and palette for displaying it. These are standard techniques which have 

been covered in other articles, and so will not be 
repeated here (and, again, the sample program 
shows how they are done). With these steps out of 
the way, the bitmap is ready for display. 


Borland C++ v4.0 
Microsoft C/C++ v8.0 
Symantec C++ v6.0 


Charles Mirho is a consultant specializing in Multimedia and Telephony. He holds a 
Master's degree in Computer Engineering from Rutgers University. He can be reached 
on CompuServe at: 70563,2671. 


February 1994 


Windows/DOS Developer’s Journal — Page 31 





































































Figure 1 Definition of BitBItQ 


BitBItO - Copy a rectangle of bits from one display context to another. 

Syntax: 

BitBIt (hdcDest, nXDest, nYDest, nWidth, nHeight, hdcSrc, nXSrc, 
nYSrc, dwRop) 

Where: 

hdcDest - is the destination device context. 

nXDest, nYDest - specifies the upper left corner of the destination 

rectangle. 

nWidth, nHeight - specifies the height and width of both source 

and destination rectangles. 

hdcSrc - is the source device context. 

nXSrc, nYSrc - specifires upper left corner of the source rectangle. 
dwRop - is the raster operation to use. 


Using BitBItO 

I use BitBItO to display the bitmap on the screen. 
BitBItO (an abbreviation for "bit block transfer") is one of 
the most useful of all the Windows GDI functions - and is 
the key to all special effects using bitmaps. 

BitBItO requires a total of nine parameters, as shown 
in Figure 1. BitBItO is designed to move bits from one 


display context to another, so two of 
the nine parameters specify source 
and destination display contexts. If 
the destination display context hap¬ 
pens to represent the screen, then 
the bits are made visible by BitBItO. 
You specify the upper-left corner, 
height, and width of the destination 
rectangle where the bits will go. You 
also specify the upper-left corner of 
the source rectangle from which the 
bits will be copied - the height and 
width are assumed to be the same as 
those specified for the destination, 
since BitBItO cannot stretch bits 
(StretchBltO can). Specifying the 
source and destination rectangles 
takes another six parameters. Figure 
2 shows source and destination rec¬ 
tangles for BitBItO and the parame¬ 
ters that specify them. 

The remaining parameter specifies the raster operation 
to use when combining the source rectangle bits with the 
destination rectangle bits. Assume that the destination dis¬ 
play context represents the screen. Then the destination 
rectangle must already contain some bits, be it the win¬ 
dow background or some other bitmap. You don't have to 
blindly copy the source bits on top of the destination. Rather, 
you can creatively combine the source and destination bits. 
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For example, you can use an XOR function to make the 
source bitmap appear in the destination device context, 
then BitBltO it with the XOR function again later to restore 
the original image (/0/Sng the same data twice restores 
the original data). Other effects can be created by select¬ 
ing other raster operations. 

Special Effect: A Bitmap Crush 

The simple way to display a bitmap is to BitBltO it to 
the screen so that it seems to appear instantaneously. A 
crush effect, on the other hand, involves drawing the bit¬ 
map from both sides toward the center, slowly enough 
that the eye can see that it appears to be 'painted' from 
the sides inward. The right and left (or top and bottom) of 
the bitmap appear to crush together and meet in the mid¬ 
dle. You still use BitBltO to draw the bitmap, but you use 
many calls, each of which copies a small block of the bit¬ 
map to the destination. I will build an example of this 
effect using an arbitrary block of four pixels square. 

effect.c (Listing 1) contains bmpCrushO, a C function to 
create the crush effect. I display the bitmap incrementally 
in small blocks. Since I'm using a square block, I specify 
both dimensions with the constant BLOCK. For my exam¬ 
ples, BLOCK is defined as four pixels. Some minor extra cod¬ 
ing is required for some effects if the bitmap dimensions 
are not a multiple of BLOCK I will bypass this complication 
to keep the discussion simple. 

The loop condition is: 


Figure 2 BitBItQ parameters in action 
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Listing 1 effect.c — Code for special bitmap effects 


♦include WINDOWS.H> 
♦include "epaint.h" 
♦include "bitmap.h" 

♦define BLOCK 4 

BITHAPINFO *p_binfo; 
LOGPALETTE *p_pal; 
BYTE .huge *hp_bits; 
HDC h.memDC; 

HBITMAP h.bmp; 
HPALETTE h_pal; 


/************************************************************************** 

* Function Name: bmpCrush 

**************************************************************************/ 
int bmpCrush (HDC hDC, int effect) 

{ 

int x. y; 

int left=0, top=0, right=(int)p_binfo->bmiHeader.biWidth-BLOCK. 
bot=(int)p_binfo->bmiHeader.biHeight-BLOCK; 

SetDIBitsChjnenCC, h.bip. 0. (W0RD)p_binfo->bmiHeader.biHeight. hp.bits. p.binfo, DIB.PAL.COLORS): 

if (effect == ID.VERTCRUSH) { 
while (top < bot) 

{ 

for (x=left;x<=right;x+=BLOCK) 

BitBlt(hDC, x. top, BLOCK, BLOCK. h.memDC, x. top. SRCCOPY); 
top += BLOCK: 

for (x=left;x<=right;x+=BLOCK) 

BitBlt(hOC. x. bot. BLOCK. BLOCK. h.memDC. x. bot. SRCCOPY): 
bot -= BLOCK: 

} //end while (not at center) 

} //End if (vertical crush) 

if (effect == ID.HORZCRUSH) { 
while (left < right) 

{ 

for (y=top;y<=bot;y+=BLOCK) 


BitBlt(hDC. right, y. BLOCK. BLOCK. h.memDC, right, y. SRCCOPY): 
right -= BLOCK: 
for (y=top:y<=bot;y+=BLOCK) 

BitBlt(hDC, left, y. BLOCK. BLOCK. h.memDC. left, y, SRCCOPY); 
left += BLOCK: 

} //end while (not at center) 

} //End if (horizontal crush) 

return 0: 

} //End function (bmpCrush) 

/************************************************************************** 

* Function Name: bmpDiagonal 

int bmpDiagonal (HDC hDC) 

{ 

int left=0. top=0, right=(int)p_binfo->bmiHeader.biWidth-BLOCK. 

bot=(int)p_binfo->bmiHeader.biHeight-BLOCK; 
int startcolumn. startrow. column, row; 

DWORD nextTime; 

SetDIBits(h_memDC, h.tnp, 0, (WORD )p_bi nfo - >bnri Header. bi Hei ght. hp.bits. p.binfo. DIB.PAL.COLORS); 

/* scan diagonals along the top edge*/ 
nextTime = GetTickCountO + 10; 
startcolumn = left; 
while (startcolumn <= right) { 
column= startcolumn; 
row= top; 

while (column >= left && row <= bot) { 

BitBlt(hDC, column, row. BLOCK. BLOCK. h.memDC, column, row, SRCCOPY); 
column -= BLOCK; 
row += BLOCK; 

) /* end while (more columns in diagonal */ 
startcolumn += BLOCK; 
while (GetTickCountO < nextTime); 
nextTime += 10; 

} /* end while (more diagonals to scan along top edge) */ 

/* scan diagonals down the right side */ 
nextTime = GetTickCountO + 10; 
startrow = top+BLOCK; 
while (startrow <= bot) { 
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Listing 1 continued 


column = right; 
row = startrow; 

while (column >= left && row <= bot) { 

BitBlt(hDC, column, row, BLOCK. BLOCK. hjnemDC, column, row. SRCCOPY); 
column -= BLOCK; 
row += BLOCK; 

} /* end while (more columns in diagonal */ 
startrow += BLOCK; 
while (GetTickCountO < nextTime); 
nextTime +=10; 

} /* end while (more diagonals to scan along right edge) */ 
return 0; 

} //End function (bmpDiagonal) 

/* End of File */ 


The variable left tracks the left column position to dis¬ 
play. The variable right tracks the right column to display. 
left is initially set to column 0, and right is set to the 
width of the display window minus BLOCK. The reason for 
subtracting BLOCK from the initial right column position is 
that, in the Windows default coordinate system, BitBltO 
uses the upper-left corner of the destination rectangle and 
applies the width right and the height down the window. 
Figure 3 shows the order in which the code draws the 
bitmap in BLOCK -sized bits to achieve the horizontal crush¬ 
ing effect. 

You can also crush from the top and bottom toward 
the center. bmpCrushO (Listing 1) also handles that case, 
with a minor adjustment to the display algorithm. 


Figure 3 Order of BitBItQs for “crush” effect 



To slow the effect down, especially on faster comput¬ 
ers, you can insert a small loop delay on the order of 
milliseconds. The following would slow the effect down by 
10 milliseconds per pair of horizontal traces: 

nextTime = GetTickCountO + 10; 
while (top < bot) 

{ 
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nextTime = GetTickCountO + 10; 
while (top < bot) 

{ 

for (x=left;x<=right;x+=BLOCK) 

BitBlt(hDC, x, top, BLOCK. BLOCK, 
h_memDC, x, top, SRCCOPY); 
top += BLOCK; 

for (x=left;x<=right;x+=BL0CK) 

BitBlt(hDC, x, bot, BLOCK, BLOCK, 
hjnemDC, x, bot, SRCCOPY); 
bot -= BLOCK; 

while (GetTickCountO < nextTime); 
nextTime += 10; 

} //end while (not at center) 

Drawing Bitmaps Diagonally 

The next special effect to examine is painting a bitmap 
diagonally. In this effect, the bitmap scrolls in diagonally 
from one corner of the display window. Again I use 
BitBltO to fill in tiny blocks of the bitmap, but this time 
the sequence is diagonally across the destination rectan¬ 
gle, not horizontally or vertically. 

The algorithm is complicated by the fact that the bit¬ 
map may not be rectangular. If the height of the bitmap 
exceeds the width, then the blocks will bump into the 
right side before reaching the bottom, as shown in Figure 
4. Likewise, if the width of the window exceeds the 
height, then the blocks will bump into the bottom before 
reaching the right side. In these situations, I continue gen¬ 
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erating diagonals by moving down the right side. The di¬ 
agonal display algorithm must be general enough to han¬ 
dle both cases. 

effect.c (Listing 1) contains bmpDiagonal(), a C function 
to draw a bitmap in diagonals from the upper-left corner 
to the lower-right. The first loop (actually two loops, one 
nested in another) scans diagonals along the top edge. 
Each diagonal begins on the top edge and ends when it 
hits either the left edge or the bottom edge. 

When the bitmap is not square, this loop block ends 
when it hits either the right-hand side or the bottom of 
the rectangle. In either case, you need a second loop 
block to complete the display by scanning down the right 
edge. Each diagonal begins on the right edge and ends 
when it hits either the bottom or the left edge. 

You could slow the effect down by using the same de¬ 
lay loop used in the crush. A diagonal effect which begins 
in the lower-right corner is easy to implement by simply 
switching top with bottom and right with left in the loops 
above. Also, you'll need to change the sign whenever 
BLOCK is added or subtracted from a loop variable. 

Conclusion 

Special effects with bitmaps are easy once you feel 
comfortable with BitBltO. Crush and diagonal effects are 
among the easier effects to implement. I have simplified 
things somewhat, however. First, I assume the default co¬ 
ordinate system with x increasing to the right and y in¬ 
creasing down. The algorithms may require some tweak¬ 
ing if you use other coordinate systems, particularly where 
either x or y or both can be negative. Also I did not ad¬ 
dress bitmaps whose dimensions are not a multiple of the 
BLOCK size. This is a simple case to handle, involving a minor 
modification to the last iteration of each display loop. □ 


Figure 4 Order of BitBItQs for “diagonal" effect 
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mrb and .shg File Formats 



Pete Davis 


Note: A few days before the final changes had to be made for this article, I ran across 
some documentation that I believe Microsoft released accidentally. This documentation 
claims to be for the .SHG fie format. I had only a few days to look it over, but it appears 
to be almost entirely incorrect. The documentation has a footnote that says "Microsoft 
Confidential," but is available on the Internet from Microsoft's anonymous FPT server, 
ftp.microsoft.coin, in the /drg/Multi media directory as SHED.ZIP. There is a notice in the 
server that claims no confidential material is available from the server, so I assume 
SHED.ZIP is not confidential. 

One of the features of Windows 3.1 online help (WinHelp) is support for 
graphical hotspots. For example, you can snap a screen shot of a dialog box 
from your application, insert the corresponding bitmap into your help file, and 
have each item (button, listbox, etc.) in the picture jump to a different help 
topic when the user selects it. You can also use a Windows metafile (. wmf) 
instead of a bitmap for your graphical hotspot. 

Microsoft calls such graphical hotspots 'segmented hyper-graphics', but you 
can ignore the fancy name and just think of a hotspot as an image (bitmap or 
Windows metafile) plus zero or more selectable, rectangular areas within the 
image. Each area can have a WinHelp macro associated with it; the macro will 
get executed if the user clicks on that portion of the graphic. 

To support graphical hotspots, Microsoft created a proprietary file format - 
.shg (for segmented hyper-graphic) files - and a tool for editing them: shed.exe. 
Documentation for the .shg file format is regularly requested by developers 
who want to generate . shg files, access their contents, build better . shg editors, 
and so on. This article reveals what I've learned about the structure of .shg files 
and provides code for dumping their contents. 

.shg versus .mrb 

Microsoft provides another tool - the multiple-resolution bitmap compiler - 
for dealing with bitmaps in help files. The problem this tool is meant to solve is 
that of different display resolutions. A bitmap drawn for an EGA screen might 
look tiny when displayed on a super-VGA monitor. The multiple-resolution bit¬ 
map compiler lets you create a single file that con¬ 
tains three bitmaps, one for each of three different 
resolutions. WinHelp then selects at runtime the bit¬ 
map closest to the resolution of the current monitor. 
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Avoiding Stretched Graphics 
in WinHelp 

WinHelp makes it easy for you to include bit¬ 
mapped graphics in the middle of your help text. For 
example, the string '{bmc logo.bmp}" in the middle 
of your help text would tell the help compiler to 
grab the bitmap file named logo.bmp and display it at 
that position in the text. This is useful for spicing up 
your help text with buttons, logos, and other graphi¬ 
cal aids. Unfortunately, once you start adding graph¬ 
ics to your WinHelp text, you will run into a nasty 
problem. The graphics look fine on your screen, but 
someone else loads up your help file and gets im¬ 
ages that look distorted - as though they were 
stretched or compressed like Silly Putty. What's going 
on? 

The problem is that WinHelp is actually trying too 
hard to be helpful. Since Windows supports different 
screen resolutions, WinHelp tries to decide what 
screen resolution you drew your bitmap for (a 
chancy proposition at best), then, if the current moni¬ 
tor is of a different resolution, calls StretchBltO to 
grow or shrink the bitmap to try to make it consume 
the same amount of screen space as on the original 
screen. 

This makes a lot of sense, conceptually. In prac¬ 
tice, though, it turns out that StretchBltO nearly al¬ 
ways renders bitmaps ugly and, if they contain text, 
unreadable. Therefore, the search for a way to get 
WinHelp to leave bitmaps alone rather than stretch 
them has been a popular topic on CompuServe. If 
you want to build high quality online help graphics, 
the best route is probably to paint three different 
copies of each bitmap and feed them into the multi¬ 
ple-resolution bitmap compiler. Many developers 
don't want to devote the time and disk space this 
requires, though, and would be more than happy to 
have a single bitmap serve all resolutions, so long as 
it was displayed as-is rather than being distorted by 
StretchBltO. 

Recently, however, David Cooper (from Microsoft 
Developer Support) demonstrated a trivial solution. It 
turns out that WinHelp will not stretch .shg files, so if 
you simply load your bitmap with shed.exe and save 
it as a .shg file, you will get a bitmap that WinHelp 
displays without stretching, no matter what the cur¬ 
rent screen resolution is. You can also load them 
into the MRB compiler, which will do exactly the 
same thing SHED does, since the SHG and MRB file 
formats are identical in this situation. Although Mi¬ 
crosoft's documentation for WinHelp is incomplete 
and fraught with errors, their online CompuServe 
support is very good. If you have WinHelp questions, 
the best place to be is in Section 16 (WinHelp/Tools) 
of forum WINSDK on CompuServe. □ 


Like the segmented hyper-graphics tool, the multiple- 
resolution bitmap (MRB) compiler is a proprietary tool with 
an undocumented file format: .mrb files. I had actually fin¬ 
ished a version of this article when I began to look into 
.mrb files. It turned out that the .mrb and .shg file formats 
are roughly identical. In fact, I hadn't realized you could 
feed a .shg file into the MRB compiler, but there it was, 
you could. The reverse is true, but not recommended. You 
can load a .mrb file into shed.exe, but only one resolution 
of the bitmap (whatever's closest to the current display) 
will be saved in the .shg file. Normally, you would create 
individual .shg files and then bring them together with the 
MRB compiler. 

Because the two formats are almost identical, I had to 
decide which naming convention to follow. I thought it 
over and made the following rationalization: the MRB 
compiler essentially turns a bitmap into a .shg file, but al¬ 
lows you to have several of them in one file. So, I decided 
to go with a .s/jj-based naming convention. (This, of 
course, had nothing to do with the fact that my original 
article was on the .shg file format and that all the struc¬ 
tures were already in that notation.) 


Listing 1 shg.h — Structure definitions for .shg 
and .mrb file formats 


/* Structures for .SHG files */ 


/* SHG File Header */ 

typedef struct tagSHGFILEHEADER { 

char sfType[2]; /* Must be Up’ or 0X706C */ 

WORD sfNumObjects; /* Number of objects in file */ 
DWORD ‘sfObjectOff; /* Offsets to objects in file */ 

) 

SHGFILEHEADER: 


/* SHG Image Header */ 
typedef struct tagSHGIMAGEHEADER ( 

WORD silmageType; /* 0x0106=.BMP 0x108=.WMF */ 

BYTE siDPI: /* Dots Per Inch x 2 (0x10 for .wmf) */ 

} 

SHGIMAGEHEADER; 

/* Defines for image type and monitor type */ 
jfdefine ITJMP 0x0106 

#define IT_WMF 0x0108 


/* SHG Bitmap Header */ 

typedef struct tagSHGBITMAPHEADER { 


BYTE sblsZero; 

/* 

Always 0x00 

*/ 

BYTE sbDPI; 

/* 

Dots Per Inch x 2 

*/ 

WORD sbTwoHund; 

/* 

0x0200 

*/ 

WORD sbNumBits: 

/* 

Number bits per pixel x 2 

*/ 

DWORD sbWidth; 

/* 

Width x 2 

*/ 

DWORD sbHeight; 

/* 

Height x 2 

*/ 

DWORD sbNumQuads; 

/* 

Number RGB Quads x 2 

*/ 

WORD sbNumlmp: 

/* 

Number of ’important’ RGB Qds 

*/ 

DWORD sbCmpSize; 

/* 

Size of Compressed BMP x 2 

*/ 

DWORD sbSizeHS; 

/* 

Size of Hotspot Data area x 2 

*/ 

DWORD sbunkl; 

DWORD sbSizelmage: 

/* 

size ImageHdr+BmpHdr+ImageDat 

*/ 


} 

SHGBITMAPHEADER; 


/* SHG Metafile Header */ 
typedef struct tagSHGMETAFILEHEADER ( 


WORD smXWidth; 
WORD smYHeight; 
WORD smUnkl; 
DWORD smCmpSize; 
DWORD smSizeHS; 
DWORD smUnk2; 


/* Width of image in metafile units 
/* Height of image in metafile units 

/* Size of compressed metafile */ 
/* Size of hot spot data area x 2 */ 
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SHGFILEHEADER 

Each .shg or .mrb file has four basic sections. Figure 1 
shows the .shg and .mrb file formats. The fourth section, 
which describes the hotspot rectangles within the image, 
is optional in both cases. A .shg file without any hotspots 
is the same as a .mrb with one bitmap. An .mrb file can 
have additional copies of the second, third, and fourth 
sections, one for each image you supplied to the MRB 
compiler. 

shg.h (Listing 1) contains the data structures I use to 
traverse these file formats. The SHGFILEHEADER structure 
starts with sfType, a two-byte field that is always equal to 
the two ASCII characters Ip'. This identifies the file as 
either a .mrb or a .shg file; you can 
use it as a sanity check to make sure 
you are dealing with the correct kind 
of file. There is no real distinction be¬ 
tween .mrb and .shg files except that 
a .mrb can have more than one ob¬ 
ject in it and a .shg can't. The second 
field in SHGFILEHEADER, sfNumObjects, 
tells you how many images (bitmaps 
or metafiles) are in the file. The final 
field in SHGFILEHEADER is sfObjectOff ; in 
the data structure, I've made this a 
pointer to DUORDs, but in the file it is 
an array of DUORDs, each of which 
contains the offset of the start of the 



DWORD smSizelmage; /* Size ImageHdr+wmfHdr+ImageDat */ 

} 

SHGMETAFILEHEADER; 

/* Documented in "Microsoft Windows 3.1 Programmer's 
Referenece Volume 4, Resources. Not in WINDOWS.H. 

This is the header for a Placeable Metafile */ 
typedef struct tagMETAFILEHEADER { 

DWORD key; 

HANDLE hmf; /* Must be 0 */ 

RECT bbox; 

WORD inch; 

DWORD reserved; /* Must be 0 */ 


Notice to Our 
Subscribers 

Occasionally, Windows/DOS 
Developer’s Journal makes its 
mailing list available to vendors 
of products we think our 
readers will find interesting. Cur¬ 
rent subscribers receive free in¬ 
formation in the mail from 
these vendors. 

If you prefer that your name 
not be used in these mailings, 
please let us know. Just copy or 
clip this form and send it with 
your name and address to: 


Windows/DOS 

□ DEVELOPER S JOURNAL 


1601 W. 23rd. St., Suite 200 
Lawrence, KS 66046-2743 


Fast, Full-Featured SQL Engine for Windows 

Ideal for mobile computing as an extension to Client/Server systems 
and applications that run on small to medium sized LAN file servers. 


=| VBQUERY 




File Edit Schema Table Transaction User Fonts 

Window Help 


Query Input 

Query Control 


select ’ from xmaslist; 


Browse Query Result 


Current 

Fyeviouv 


Update 

n—i 

Next 

Last 

Delete 


RECIPIENT ROBERTA WANG 
ADDRESS 


...MEMO ... 


CARD PIC - BLOB .. 


SEE 


ExecujionJjme 
00:00:01 


Schema: BLOBTEST 


Column 


IS BLOB Editor (Field CARD_ 


Exit! Duplay As Edit 


ROBERTA BANG 
ROGER SMITH 
JAMES DARIN 
JERRY TSAI 
JULIA ROSENBERG 



Blob Size (bytes): 40640 


Quadbase-SQL for Windows v2.0 is an industrial-strength SQL relational database 
engine, bundled with a set of powerful tools, that allows Windows developers to build 
applications using various languages like Visual Basic, Realizer, Toolbook, 
SQLWindows, C, C++, ObjectView, etc. A unique language-independent embedded SQL 
interface included with the system makes using any Windows language easy. The SQL 
engine, implemented as a DLL, is fully ANSI SQL 86 level 2 compliant, and supports the 
Microsoft ODBC standard, which provides seamless, object-oriented access from Visual 
Basic v2.0. Extensions include referential integrity, scroll cursors, and outer join, along 
with other advanced features such as multi-user concurrency control, crash recovery, 
transaction processing, multiple instances. BLOB data, and read-only schemas for CD 
ROMs. The engine is very fast and compact, and is especially designed to manage large 
amounts of data efficiently. Visual Basic development is enhanced by embedded SQL and 
custom controls for browsing and data entry. dQUERY, an award winning query tool/report 
writer, and VBQUERY, an interactive query tool for Windows, are included for quick 
prototyping of SQL statements. A *C language API is also provided together with an 
embedded SQL preprocessor. The native file format is dBASE. This product is ideal for 
small to medium sized LAN file servers, notebook, or pen-based systems. Users can benefit 
from advanced relational database features while opening a migration path to SQL servers. 

Quadbase Systems Inc. 

790 Lucerne Dr. #51 
Sunnyvale, CA 94086 
Tel: (408) 738-6989 
Fax: (408) 738-6980 


Call for a free demo disk now. 
Find out why AT&T, Hewlett 
Packard, Nike, EPA, GE and 
many more major organizations 
use Quadbase products. 


R 



February 1994 


□ Request 175 on Reader Service Card □ 

Windows/DOS Developer’s Journal — Page 39 











































































































Listing 1 continued 


WORD checksum; 

} 

METAFILEHEADER; 

/* Hot Spot Header */ 
typedef struct tagHOTSPOTHEADER { 

BYTE hhVersion; /* Always 0x01 

*/ 

WORD hhNumHS: /* Number of Hot Spots 

*/ 

DWORD hhContextOffset; /* Offset to Cntxt Strings 

} 

HOTSPOTHEADER; 

/* Hot Spot Record */ 
typedef struct tagHOTSPOTRECORD { 

WORD hrType; /* Hot Spot Type. See below 

S IDs*/ 

*/ 

BYTE hrZero; /* Always 0 

*/ 

WORD hrLeft; /* Bounding box of Hot Spot 

*/ 

WORD hrTop; 

WORD hrRight; 

WORD hrBottom; 

DWORD hrMacOffset;/* Offset to macro for Hot Spot 

*/ 

HOTSPOTRECORD; 

#define HS INVISJUMP 0X04E7 

YAdefine HS INVISPOPUP 0X04E6 

ifdefine HS INVISMACRO 0X04CC 

#define HS VISJUMP 0X00E3 

//define HS VISPOPUP 0X00E2 

//define HSJ/ISMACRO 0X00C8 

/* End of File */ 
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Listing 2 shgdump.c — Program to dump/extract 
.shg and .mrb files 


#1nc1ude <windows.h> 

♦include <stdl1b.h> 

♦include <stdio.h> 

♦Include <string.h> 

♦include "SHG.H" 

char outfile[128]; /* Output file */ 

BOOL rebuild; 

/* Flags an incorrect value for known fields */ 

♦define CheckUVal(a.b) \ 
if (a != b) { \ 

printfCUINT: Hot a 0xX04X?\n\n 0xX04x\n".b. a); exit(l); } } 

♦define CheckBVal(a.b) \ 

{If (a != b) { \ 

printf("BYTE: Not a 0xX02X?\n\n 0xX02x\n",b, a); exit(l); } } 

♦define ReadStringCf. s) { char *p = (char *)(s); \ 

while ((*p++ = fgetc(f)) 1= 0) ; *p = 0; } 

/* Reads in a BYTE. If it's odd, it reads in a WORD. Returns 1/2 value */ 
WORD ReadWordVaKFILE *SHGFile) { 

BYTE a. b; 

b = 0; 

freadtta. sizeof(a), 1. SHGFile); 

if (a X 2) freadUb. sizeof(b), 1. SHGFile); 

return (WORD) ((W0RD)b*256 + a) /2; 


/* Reads in a WORD. If it’s odd. it reads in a DWORD. Returns 1/2 value */ 
DWORD ReadDWordVaKFILE ‘SHGFile) { 

WORD a, b; 

b = 0; 

freadtta. slzeof(a). 1. SHGFile); 

if (a X 2) freadUb. sizeof(b). 1. SHGFile); 

return (DWORD) ((DW0RD)b*65536 + a) /2; 


/* Perforins RLE decompression for bitmaps and metafiles */ 

DWORD doRLE(FILE ‘InFile. FILE ‘OutFile. DWORD NumBytes) { 

DWORD 1=1. imagesize=0; 

BYTE j. count, data; 

do { 

fread(&count, sizeof(count), 1. InFile); 

1 ++; 

/* If the 8th bit Is set. lower 7 bits has ♦ bytes to copy */ 
If (count & 0x80) { 
count -=0x80; 
while (count--) { 

freadUdata, sizeof(data). 1. InFile); 
i++; 

fwriteUdata, sizeof(data), 1. OutFile); 

} 

) 

/* If 8th bit not set. it's an RLE count */ 
else { 

count = count & 0x7F; 
fread(&data. sizeof(data), 1, InFile); 

1 ++; 

/* Write out uncompressed */ 
for (j = 1; j <= count; j++, imagesize++) 
fwrite(&data. sizeof(data). 1. OutFile); 

) 

} 

whiled < NumBytes); 


return imagesize; 

} 

/* Dumps HotSpot data from .SHG file */ 
void DumpHotSpots(FILE ‘SHGFile) { 

HOTSPOTHEADER HSHead; 

HOTSPOTRECORD HSRec; 

WORD 1. NumMacs = 0; 
char AString[128]; 

freadt&HSHead, sizeof(HSHead). 1. SHGFile); 

ford = 1; 1 <= HSHead.hhNumHS; i++) { 

freadttHSRec. sizeof(HSRec). 1. SHGFile); 
printf("Hot Spot Xu>". i); 
switch(HSRec.hrType) { 
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corresponding image in the file. sfNumObjects tells you how 
many DWORD file offsets follow it in the file. 

Each DWORD offset in the sfObjectOff array contains the 
byte offset of a SHGIMAGEHEADER structure, as defined in 
shg.h (Listing 1). The SHGIMAGEHEADER structure has informa¬ 
tion about the actual image type - bitmap or metafile. 
The silmageType field indicates whether the data to follow 
is a metafile (0x0108) or bitmap (0x0106). Next comes the 
si DPI field, which apparently contains twice the number of 
dots per inch for a bitmap. If the file is a metafile, this 
value seems to always be 0x10. 

What follows the SHGIMAGEHEADER in the file depends on 
whether the image is a bitmap or a metafile, so I will 
cover each separately. 

Bitmap Images 

Each bitmap image starts with a SHGBITMAPHEADER struc¬ 
ture, as defined in shg.h (Listing 1). This structure contains 
some of the same information that the BITMAPFILEHEADER 
and BITMAPINFOHEADER (defined in windows.h) structures hold 
in standard bitmap definitions, but the format is com¬ 
pletely different. Among other things, many of the values 
are doubled. As best I can tell, this is a somewhat corny 
attempt to save a couple bytes of space, it seems like a 
lot more effort than it's worth, but it works as follows: 

Most of the fields listed as DWORDs in my SHGBITMAPHEADER 
structure are actually stored as WORDS in the file, but a WORD 
wouldn't be large enough to hold, say, the size of a com¬ 
plex 1024x768x256 bitmap, even with RLE compression. 
So, when you divide the value by two, you need to check 
the remainder. If there is a remainder (that is, bit 0 is set), 
the size of the field is actually twice as large in the file. For 
example, you would read in the sbHSOffset field as a WORD. 
If the result is 0x4201, an odd number, then dividing it by 
two would produce a remainder. That would mean the 
field was actually a DWORD, so you'd then have to read the 
second WORD in the DWORD and divide the entire DWORD by 
two. 

shgdump.c (Listing 2) contains the function 
ReadBMHeaderO, which reads the bitmap header from the 
file into the more convenient SHGBITMAPHEADER structure. 
ReadBMHeaderO calls ReadWORDValO and ReadDWORDVaK) to ac¬ 
tually read in a BYTE and WORD, respectively. These functions 
check if bit 0 is set and, if it is, read in a second BYTE or 
WORD, and then divide the total value by two. 

The sbNumQuads field is the number of RGBQUADs (a color 
definition structure defined in windows.h) in the palette ta¬ 
ble. The sbNumlmp field tells how many of these RGBQUADs 
are important. Essentially, this specifies how many of 
these are required to produce a realistic rendition of the 
bitmap. This field usually isn't used. 

The sbSizelmage field tells how large the image is, from 
the SHGIMAGEHEADER to the end of the data for the image. 
Following the SHGBITMAPHEADER is a list of RGBQUADs of length 
sbNumQuads (after sbNumQuads has been divided by 2). Follow¬ 
ing this is the data for the bitmap, which is compressed 
with an RLE compression scheme. 


Listing 2 continued 


case HSJNVISJUMP: 

printf("Invisible Jump: "); 
break; 

case HSJNVISPOPUP: 

printf("Invisible Popup: "); 
break; 

case HSJNVISMACRO: 

printf("Invisible Macro: "); 

NumMacs++; 

break; 

case HSJISJUMP: 

printf("V1sible Jump: "); 
break; 

case HSJISPOPUP: 

printf("Visible Popup: "); 
break; 

case HSJISMACRO: 

printf("Visible Macro: "); 

NumMacs-H-; 

break; 

default: 

printf("Invalid Record Type\n"); 
return; 

} 

printf("[Xu.Xu,Xu.Xu]\n", HSRec.hrLeft, HSRec.hrTop, 
HSRec.hrLeft + HSRec.hrRight. HSRec.hrTop+HSRec.hrBottom); 

} 

ford = 1; 1 <= NumMacs; i++) { 

ReadString(SHGFi1e. AString); 
printf("Macro Xu> X$\n", 1. AString); 

} 

ford = 1; i <= HSHead.hhNumHS; i++) { 

ReadStringtSHGFile, AString); 

printf("Hotspot 10 Xu> Xs\n", 1, AString); 

ReadString(SHGFile, AString); 

printf("Context String Xu> Xs\n\n", 1. AString); 

) 

} 
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Listing 2 continued 


/* Reads in a bitmap header. Doubles the 

printf("Height of bitmap: XIu\n", SHGBM.sbHeight); 
printf("Number of RGB Quads: Xlu\n". SHGBM.sbNumQuads); 

size of certain fields when necessary. */ 

printf("Number of Important Quads = 0xX04X\n", SHGBM.sbNumlmp); 

void ReadBMHeader(FILE *SHGFile. SHGBITMAPHEADER *SHGBM) { 

printf("Offset to Hotspots: Xlu\n", SHGBM.sbCmpSize); 

/* Read first three fields unmodified */ 

printf("Size of hot-spot data: XIu\n", SHGBM.sbSizeHS); 
printf("sbunkl = 0xX081X\n", SHGBM.sbunkl); 

fread(&(SHGBM->sbIsZero), 1. 1. SHGFile); 

printf("sbSizeImage= 0xX04X\n", SHGBM.sbSizelmage); 

SHGBM->sbDPI = ReadWordVal(SHGFile); 

BuildBitmap(SHGFile. &SHGBM. ImageNum); 

fread(&(SHGBM->sbTwoHund), 2. 1. SHGFile); 

} 

SHGBM->sbNumBits = ReadWordVal(SHGFile); 

SHGBM->sbWidth = ReadDWordVal(SHGFile); 

/* Reads in a metafile header. Doubles the 

SHGBM->sbHeight = ReadDWordVal(SHGFile); 

size of certain fields when necessary. */ 

SHGBM->sbNumQuads = ReadDWordVal(SHGFile); 

void ReadWMHeader(FILE *SHGFile, SHGMETAFILEHEADER *SHGWM) { 

fread(&(SHGBM->sbNumImp), 2. 1. SHGFile); 

SHGBM->sbCmpSize = ReadDWordVal (SHGFile); 

/* Read first three fields unmodified */ 

SHGBM->sbSizeHS = ReadDWordVal(SHGFile); 

fread(i(SHGWM->smXWidth). 6. 1. SHGFile); 

fread(&(SHGBM->sbunkl), 4. 1. SHGFile); 

SHGWM->smCmpSize = ReadDWordVal(SHGFile); 

fread(&(SHGBM->sbSizelmage). 4, 1. SHGFile); 

SHGWM->smSizeHS = ReadDWordVal(SHGFile); 

} 

fread(&(SHGWM->smUnk2). 8. 1. SHGFile); 

) 

/* Build the bitmap file from the .SHG file *7 

void BuildBitmap(FILE *SHGFile. SHGBITMAPHEADER *SHGBM, int ImageNum) { 

/* Converts the regular metafile to a placeable metafile */ 

BITMAPFILEHEADER bmfh; 

BITMAPINFOHEADER bmih; 

BOOL MakePlaceable(FILE *TMPFi1e. FILE *WMFFile) { 

METAFILEHEADER WMFHead; 

FILE *BMPFile; 

METAHEADER MetaHead; 

RGBQUAD AnRGBQuad; 

METARECORD MetaRec; 

char Real0ut[128]. ext[4]; 

RECT TempRect; 

int i; 

DWORD i; 

itoa(ImageNum. ext. 10); 
strcpy(Real Out, outfile); 

WORD AWord; 

WMFHead.key = 0X9AC6CDD7L; /* file identifier */ 

strcat(Real Out. "."); 

WMFHead.hmf = 0; 

strcat(RealOut, ext); 

WMFHead.inch = 576; 

if ((BMPFile = fopen(Real Out. "wb+")) == NULL) { 

WMFHead.reserved = 0; 

printf("Error opening output bitmap file\n"); 
exit(l); 

) 

/* Write record. No info in it yet, but fills space in file */ 

freadt&MetaHead, sizeof(MetaHead), 1. TMPFile); 

/* Get the SetWindowOrg function first */ 

fwrite(ibmfh, sizeof(bmfh), 1, BMPFile); 

fread(&MetaRec, 6. 1. TMPFile); 

bmih.biSize = sizeof(bmih); 

if (MetaRec.rdFunction != 0X020B) { 

printf("Error: Unable to create Placeable Metafile!\n"); 

bmih.biWidth = SHGBM->sbWidth; 

return FALSE; 

bmih.biHeight = SHGBM->sbHeight; 

) 

bmih.biPlanes = 1; 

freadUTempRect.top, 2. 1, TMPFile): 

bmih.biBitCount = SHGBM->sbNumBits; 

freadUTempRect.left, 2. 1. TMPFile); 

bmih.biCompression = BI_RGB; 

bmih.biSizelmage = 0; /* We'll fill this in later */ 

/* Get the SetWindowExt function */ 

bmih.biXPelsPerMeter = 0; 

fread(&MetaRec. 6, 1, TMPFile); 

bmih.biYPelsPerMeter = 0; 

if (MetaRec.rdFunction != 0x0200 { 

bmih.biCIrUsed = 0; 

printf("This file wasn’t created from a placeable metafile!\n"); 

bmih.biClrlmportant = 0; 

return FALSE; 

fwrite(&bmih. sizeof(bmih). 1, BMPFile); 

} 

for(i = 0; i < SHGBM->sbNumQuads; i++) { 

freadUTempRect.bottom, 2, 1. TMPFile); 

fread(&AnRGBQuad. sizeof(AnRGBQuad), 1. SHGFile); 

fread(&TempRect.right, 2, 1, TMPFile); 

fwrite(&AnRGBQuad. sizeof(AnRGBQuad). 1. BMPFile); 

} 

memcpy(iWMFHead.bbox. iTempRect, sizeof(TempRect)); 

bmih.biSizelmage = doRLE(SHGFile, BMPFile, SHGBM->sbCmpSize); 

WMFHead.checksum = 0x0000 * 0xCDD7 A 0x9AC6 A WMFHead.hmf A 

if (SHGBM->sbSizeHS) DumpHotSpots(SHGFile); 
else printfCNo Hot Spot data for this Bitmap.\n"); 

TempRect.left A TempRect.top A TempRect.right A 

TempRect.bottom A WMFHead.inch; 

/* Since we took out the first two records, we need 

bmfh.bfType = 0x4D42: /* 'BM* */ 

to subtract their length from the metafile size. */ 

MetaHead.mtSize -= 10; 

bmfh.bfSize = ftell(BMPFile); 
bmfh.bfReservedl = 0; 

fwrite(&WMFHead, sizeof(WMFHead). 1. WMFFile); 

bmfh.bfReserved2 = 0; 

fwrite(&MetaHead, sizeof(MetaHead), 1, WMFFile); 

bmfh.bfOffBits = sizeof(bmfh) + sizeof(bmih) + (4*SHGBM->sbNumQuads); 

for (i=0; KMetaHead.mtSize; i++) { 

/* Go to the beginning and fix up header records */ 

fread(&AWord, sizeof(AWord), 1, TMPFile); 
fwrite(iAWord, sizeof(AWord). 1. WMFFile); 

fseek(BMPFile, 0. 0); 

1 

fwrite(4bmfh, sizeof(bmfh), 1, BMPFile); 

return TRUE; 

fseek(BMPFile, sizeof(bmfh). 0); 

} 

fread(&bmih, sizeof(bmih), 1, BMPFile); 
fseek(BMPFile, sizeof(bmfh), 0); 

/* Writes the .TMP file from the .SHG file */ 

fwrite(ibmih, sizeof(bmih), 1, BMPFile); 

void BuildWMF(FILE *SHGFile, SHGMETAFILEHEADER *SHGWM, int ImageNum) { 

fclose(BMPFile); 

char outfile2[128]. Real0ut[128]. ext[4] : 

DWORD ImageSize; 

} 

FILE *TMPFile, *WMFFi1e; 

/* Dump bitmap data in .SHG file */ 

strcpy(RealOut, outfile); 

void BitMapDump(FILE *SHGFile. int ImageNum) { 

strcpy(outfile2. outfile); 

SHGBITMAPHEADER SHGBM; 

itoa(ImageNum. ext. 10); 

printf("\n\n File is a BITMAP. Data follows: \n\n"); 

strcat(outfile2, ".tmp"); 

ReadBMHeader(SHGFi1e. &SHGBM); 

if ((TMPFile = fopen(outfile2, "wb+")) == NULL) { 

printfCDPI = 0xX04X\n". SHGBM.sbDPI); 

printf("Error opening output temp file\n"); 

printfCTwoHundred = 0x%04X\n", SHGBM.sbTwoHund); 

exit(l); 

printfCNumBits per Pixel = Xu\n". SHGBM.sbNumBits); 

} 

printf("Width of bitmap: %lu\n". SHGBM.sbWidth); 
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The RLE compression used in .shg and .mrb files is actu¬ 
ally simpler than the regular bitmap implementation. The 
decompression algorithm follows these steps: 

1. If not at the end of the data, read 1 byte into count, else 
quit. 

2. If bit 8 of count is set, go to step 5. 

3. Copy the next input byte count times to the output file. 

4. Go to step 1. 

5. Subtract 0x80 from count. 

6. Copy next count bytes from the input file to the output 
file. 

7. Go to step 2. 

That's all there is to it. If you want to implement the 
RLE compression supported by bitmaps in your output bit¬ 
map, you can use the algorithm described in the Microsoft 
Windows 3. 7 Programmer's Reference, Volume 4. In my im¬ 
plementation, I chose to forgo the trouble and simply out¬ 
put an uncompressed bitmap. 


Metafiles 

Metafiles are, for the most part, kept in their natural 
state in .shg files. (A good reference to the metafile format 
is the Microsoft Windows 3. 7 Programmer's Reference, Volume 
4. The metafile format is a bit complex in itself, and I 
don't have room to describe it here.) Although the MRB 
compiler will support metafiles, metafiles are device-inde¬ 
pendent, so there is no reason to put multiple metafiles in 
a .mrb file. 

shed.exe (Microsoft's tool for editing .shg files) will only 
read "placeable' metafiles, that is, metafiles preceded by a 
METAFILEHEADER header (defined in the Windows API help 
file, but not in windows.h). The information in this header 
helps describe how big the original drawing is in inches, 
giving other programs a chance to draw the image in a 
similar size, even on a different resolution monitor. 

shed.exe makes two alterations to metafiles when it 
stores them in a .shg file. The first alteration is to remove 


Listing 2 continued 


/* Step 1 decompress file to temp file */ 

SHGHead.sfType[l]); 

ImageSize = doRLE(SHGFi1e. TMPFile, SHGWM->smCmpSize); 

exit(l); 

/* Realign for Hot-Spot data (27 = size of all headers) */ 


fseek(SHGFile, (2£+SHGWM->smCmpSize). SEEK.SET); 

for(i=0; i < SHGHead.sfNumObjects; i++) { 

if (SHGWM->smSizeHS ) DumpHotSpots ( SHGFi1e ) ; 

fseek(SHGFile. SHGHead.sfObjectOff[i ] . SEEKJET); 

else printf("No Hot Spot Data for this metafile.\n"); 

/* Read in Image Header */ 

strcat(RealOut, ext); 

if (CWMFFile = fopen(Real Out. "wb+")) == NULL) { 

fread(&SHGImage, sizeof(SHGImage). 1. SHGFile); 

if (SHGImage.siImageType == IT BMP) 

printfCError opening output metafile\n"); 

BitMapDump ( SHGFi1e, i); 

exit(l); 

else if (SHGImage.siImageType == IT WMF) 

j 

WMFDump ( SHGFi 1 e. i); 

fseek(TMPFile. 0. 0); 

else { 

if ( IMakePlaceable(TMPFi1e. WMFFile)) { 

pri ntf ("Unknown sf ImageType valueAn"); 

fclose(TMPFile); 

exit(l); 

fclose(WMFFile); 

) 

remove(Real Out); 

j 

renameCoutfi1e2. RealOut); 

free(SHGHead.sfObjectOff); 

else { 


fclose(TMPFile); 

/* Show usage for SHGDUMP */ 

fcloseCWMFFi1e); 

void Usage(void) { 

remove(outfile2); 

printf("Usage:\n"); 

i 

printf(" SHGDUMP shgfi 1 e[.shg] \n"); 

i 

printf!" shgfile - Name of .SHG f11e\n”); 

/* Dump the .WMF data from the .SHG file */ 


void WMFDumpCFILE *SHGFi1e. int ImageNum) { 

/* main routine */ 

SHGMETAFILEHEADER SHGWM; 

DWORD ImageSize = 0; 

int main(int argc, char *argv[]) { 

char filename[40]; 

ReadWMHeader(SHGFi1e. &SHGWM) ; 

FILE *SHGFi1e; 
char *i ; 

printf("Width = 0x%04X\n", SHGWM.smXWidth); 
printf ( "Height = 0xX04X\n", SHGWM.smYHeight); 

If (argc < 2) { 

printfCUnknownl = 0x%04X\n", SHGWM.smUnkl); 

UsageO; 

printf("Offset to Hotspots: Xu\n". SHGWM.smCmpSize); 

return EXIT FAILURE; 

printf("Size Hot Spot Data: Xu\n", SHGWM.smSizeHS); 

} 

printf("Unknown2 = 0xX081X\n". SHGWM.smUnk2); 
printf("Size Image = 0x%081X\n", SHGWM.smSizelmage); 

strcpy(fi1ename. argv[l]); 

Bui 1dWMF(SHGFile. &SHGWM, ImageNum); 

strupr(filename); 

} 

strcpy(outfile. filename); 

/* Dumps the .SHG file */ 

i = strchr(outfile, ’.’); 

void SHGDump(FILE *SHGFile) { 

if ( i ) *i = 0x00; 

SHGFILEHEADER SHGHead; 

SHGIMAGEHEADER SHGImage; 

else strcat(filename, ".SHG"); 

if ((SHGFile = fopen(filename, "rb")) == NULL) { 

int i; 

printf("Xs does not exist!", filename); 

/* Read In first 4 bytes */ 

return EXIT FAILURE; 

} 

freadUSHGHead, 4. 1. SHGFile); 

SHGHead.sfObjectOff=mal1oc(4*SHGHead.sfNumObjects ); 

SHGDump(SHGFile); 

fread(SHGHead.sfObjectOff. 4. SHGHead.sfNumObjects. SHGFile); 

fclose(SHGFile); 

/* Make sure it’s a .SHG or .MRB file */ 

return EXIT SUCCESS; 

} 

if (strncmp(SHGHead.sfType, "lp". 2)) { 

/* End of File */ 

printf("Invalid .SHG or .MRB file! \n\nType: %c%c\n". SHGHead.sflype[0]. 
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C CODE FOR THE PC 

source code, of course 

a dated! Graphic 7.0 (high-resolution, scientific plots in color* hardcopy, contour plots, device independence).$370 

eaper! X/DOS and Xt/DOS (Xlib with X client and Xt toolkit for DOS; port X code to DOS; Xt/DOS r equ ires X/DOS and 32-bit compiler) . . each $300 
ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

The Snooper (Ethernet protocol analyzer for Novell NetWare and LAN Manager Networks; capture packets; real-time display).$275 

Embedded BIOS (full-featured, real-time input/output system; PC, XX AT; for example, 80186 with 8259 interrupt controller).$260 

C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner, specify C or C++)$250 

TUrboIJjX (Release 3.0; HP, PS, dot drivers; CM fonts; LaTgX; MetaFont).$250 

Rogue Wave tools.h-f 4- or math.h-f + Class Library (extensive docs).each $240 

NE W! Crasher! (platform-independent data compression; beats PK and LH on binary files; directory trees; portable C).each $215 

COMM-DRV (complete interrupt-driven serial communication libraries & device drivers; full source).$155 

TE Editor Developer’s Kit Ver. 3.0 (full screen editor, undo command, multiple windows; with Word Processing $230).$155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

NE W! XASM (cross assemblers & utility programs; 65xx, 68xx, 80xx; Intel or Motorola hex format; macro preprocessor).$150 

Delorie GCC for MS-DOS (Version 2.2.2; includes C+ +, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs) .$140 

Ibrow (Version 4.1; programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$135 

Booter Tbolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) .$120 

386BSD Version 0.1 & LINUX Version 0.96 (two Unix clones for Intel 386) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

DA (disassembler for Microsoft’s New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).$95 

Script Interpreter (a command script interpreter for DOS-based systems; C-hke script language; lots of features).$90 

CELP 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps; Unfit code).$80 

CPPCOMM (C++ serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem).$75 

ET Neural Net (back error propagation and Kohonen; specify DOS text, DOS VGS, or Windows).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C-|—(-).$65 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS (Purdue Compiler Construction Tool Set; ported to Microsoft C; like YACC and LEX together with lots of additional features) . . . $60 

Container Lite V 1.82 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitrary precision floating point arithmetic ana functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CUPS Version 6.0 (rule-based expert system generator; Windows compatible; hardcopy manuals additional) .$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) .$50 

Editor Pack (20 public domain editors; micromacs 3.12, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised).$45 

TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) .$40 

NEW! APL for DOS (full implementation in C, uses ASCII character set).$40 

Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man's C++; C macro package which implements C++in C) .$35 

RXC & EGREP Version 20 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes C and C+ + grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags++, lots of .el files) .$25 

UUPC Pack (UUCP for the PC; UUPC Version 1.1 IV, smail & snews) .$25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

Updated! FLEX (fast lexical analyzer generator; new, improved LEX; BSD Version 24.2 with docs) .$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

Simple Socket Library (Unix, VMS and MS-DOS; sits on TCP/IP stack).$20 

Bywater BASIC Version 1.10 (complete BASIC interpreter and interactive programming environment).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, ’’common sense”, concept related searches) .$500 

Moby Pronundator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moty Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (18*>,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,000 words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

Dictionary Word List (234,932 words in alphabetical order) .$60 

Roget’s 1911 Thesaurus .$40 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) $35 

The World Digitized (100,000 longitude/latitude of world country boundaries).$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 
FontMaster II CD Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB) . . . $70 

Updated! Prime Time for Unix (Volume 3, No. 1, January, 1994; over 6GB of Unix C code).$60 

Walnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included).$55 

Linux/GNU/X by Yggdrasil Computing (1st production release; run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more) . $45 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$40 

Walnut Creek C User’s Group (Volumes 100 to 364).$40 

InfoMagic Unix (three public domain Unix systems: 386BSD (version 0.1), Linux (version 0.99.10), and NetBSD).$40 

InfoMagic Source Code (Berkeley Net/2 MACH, GNU, Interviews, X, Andrew, XFree, Demacs & Winemacs, djgpp, Modula-3, etc.) . . . $40 

NEW! Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) .$35 

Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Walnut Creek X11R5 and GNU (X11R5 with contributed and comp.sourcesjc, over 120 GNU programs, complete C source).$35 

Iftfclnut Creek Usenet and Simtel Unix-C (600MB).$35 

NEW! Ifalnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source).$35 

Austin Code Works Internet Warrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Thimpet, TCP/IP, FAQs, drivers, docs) ... $35 

NEW! NetGems of 1991 (comp, sources. *, alt.sources.* of 1991, plus X11R5 and GNUware and RFCS; Unix file system not ISO-9660) .$20 

Walnut Creek Simtel 20 MSDOS Archive (C source oode but lots of other stuff too)...$20 

Sprite Network Operating System (source code & documentation of Ousterhout’s Sprite O/S; Sun and DECStation boot images).$20 

The Austin Code Works Voice: (512) 258-0785 

11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-13)2 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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the METAFILEHEADER at the beginning of the metafile and 
replace it with two metafile functions. These two functions 
- 0X020B (SetUindowOrgO) and 0X020C (SetUindowExtO) - pro¬ 
vide the same functionality as the 'piaceable' bitmap 
header. There is an exception: if a SetUindowExtO function 
already exists in the metafile, the METAFILEHEADER is tossed 
out altogether and SetUindowOrgO is assumed to be set to 
0,0. The second alteration is to compress the entire 
metafile, starting at the METAHEADER record, with the same RLE 
algorithm used for the bitmaps. So, you can just decompress 
the metafile image data from the .shg file to obtain a legal 
Windows metafile that you can store in a .mf file or play 
back by passing it to PlayMetaFileO. if you really need a 
piaceable metafile, you will have to create the piaceable 
metafile header from information in the calls to SetUin- 
douOrgO and SetUindowExtO that reside in the .shg metafile 
image data. 


Figure 1 .shg and .mrb file format overview 


SHG File Header 


SHG Image Header 


SHG Bitmap Header or 
SHG Metafile Header 


Bitmap or Metafile Data 


Hotspot Header 


Hotspot Records 


Macro Strings (optional) 


Pairs of Context IDs and 
Context Strings 


Additional Sections 2-4 
(Optional: For MRB Only) 


Section 1 

Section 2 

^ Section 3 
V Section 4 

J 


Hotspots 

Following the metafile or bitmap are the actual hot¬ 
spots. Figure 2 shows the dialog box that shed.exe uses to 
let you edit hotspot information; it provides a good sum¬ 
mary of the information you can associate with each hot¬ 
spot: 

• context string - this is either the context string for a 
help topic, or a WinFleip macro string. 

• type - the type of action to take when the user selects 
this hotspot, either "jump", "popup", or "macro". 

• attribute - specifies whether the hotspot rectangle will 
be visible or not when WinHelp draws the image. 

• hotspot ID - an arbitrary string to name the hotspot, 
useful for helping you locate invisible hotspots if you 
want to make changes. This name is used only by 
shed.exe to help you edit the image, not by WinHelp. 

• bounding box - the position and size of the hotspot 
rectangle. 

The hotspot data in the .shg file starts with the HOT- 
SPOTHEADER structure shown in shg.h (Listing 1). This simple 
structure contains the number of hotspots and the offset 
of the context strings and hotspot IDs (relative to the end 
of the last HOTSPOTRECORD). 

Following the header is a list of HOTSPOTRECORD records 
(defined in shg.h), one for each hotspot. The first field is 
the record type. There are six record types and each speci¬ 
fies whether the record is a jump, popup, or macro, and 
whether the hotspot is invisible or not. Next is the bounding 
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Windows Sockets, Berkeley Sockets 
Kernel, RPC/XDR, FTP and Telnet 
toolkits ... all in one 
100% DLL (uses only 4K DOS memory) 
Uses less memory than any other DLL or 
TSR implementation even when loaded 
Up to 128 concurrent sockets 
Coexists with Novell, Banyan or LAN 
Manager at no additional cost 
Supports NDIS, ODI and Packet drivers; 
SLIP and PPP with scripting 
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Telnet, LPR/LPD, Back-Up with TAR 
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Attributes 


Binding 

Context String: my_context_string| 


Jump 

4 

Attribute: 

Invisible 


Hotspot Id: My Hotspot ID 
Bounding Box 
Left: 


61 


Right: 


162 


T op: 
Bottom: 


54 


127 


OK 


Cancel 



rectangle for the hot spot, with values given in pixels for 
bitmaps and metafile units for metafiles. In placeable 
metafiles, a field in the header called inch tells how many 
metafile units there are to an inch. This value is set to 576 
for . sAg files created from metafiles. Following the bound¬ 
ing rectangle is the offset for the hotspot's macro or con¬ 
text string, if there is one. 

Following all the hotspot records is a list of null-termi¬ 
nated strings containing all of the existing macros. The 


macro offsets in the HOTSPOTRECORD structures are relative to 
the start of this list, so the first HOTSPOTRECORD with a macro 
will have a hrMacOffset value of 0x00000000. 

Following the macros is a list of null-terminated strings. 
Two strings are associated with each record. The first 
string is the hotspot ID (an arbitrary string that you can 
use to locate the hotspot in the hotspot editor). The sec¬ 
ond is either a context string or a macro, depending on 
the hotspot type. As you'll have noticed, the macro strings 
are listed twice, once in the list of macros and once in the 
list of hotspot IDs and strings. 

Summary 

That's really all there is to it. shgdump.exe dumps some 
information about the .shg or .mrb file and converts it to 
its original format, either a Windows bitmap or metafile. If 
the file is a .mrb, shgdump.exe extracts each individual bit¬ 
map and/or metafile into a separate file. These files might 
not be exactly like the originals, as .shg files and .mrb files 
don't require all the information that the original Win¬ 
dows bitmap and metafiles contain, so I had to make 
some assumptions. There are still a couple of unknown 
fields: if you figure them out, I'd love to hear from you. As 
with the WinHelp file format. I'll make all new information 
on the .shg file format available on my BBS at (703) 503- 
3021. 1 can also be reached via CompuServe at 
71644,3570. □ 


One Party! 

Why get bogged down with third party DOS extenders and C compilers, 
when all you want Is to write 32-blt Windows programs? With LPA 
386-PROLOG 2.0, you get everything you need to write really stunning 
applications: 


O True 32-blt stacks, heaps, programs Se data 
O Fully programmable dliojgs, menus & windows 
O High level access to the GUI and operating system 
O Two-way data exchange through DLLs 


Not to mention the Integrated source level debugger, multl-flle program 
editor, Incremental and optimising compilers, and full Prolog predicate 
library. 


All this, and much more, without the 
need to buy any third party DOS 
extenders or C compilers. 

386-PROLOG Is your one party, 32-blt 
applications development environment 
for Windows 3.1! 
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Logic Programming Associates Ltd 
Studio 4, RVPB, Trinity Road, London, SWI8 3SX, England 
Tel: (US Toll Free) 1-800-949-7567, (Int) +44 81 871 2016 
Email: lpa@dx.compulink.co.uk - CompuServe: 100135,134 
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COMPUTER SYSTEMS 

ANALYST 

Growing, international, technical publishing company 
is seeking a full-time position which includes UNIX 
system administration; software development and 
maintenance; customer technical support; and 
hardware installation and maintenance. Candidates will 
be familiar with application development using modern 
database tools, be able to work within a team, and 
maintain their own code in addition to the code 
developed by others. B.S. in computer science or 
equivalent experience required. Interest in technical 
writing preferred. 

R&D Publications, Inc. is an equal opportunity employer 
concerned with creating a pleasant work atmosphere. 
If you are looking for an enjoyable working environment 
with a reliable company, please send a cover letter and 
resume to: 

Kelly Calvert, Human Resources Manager 

1601 West 23rd St., Suite 200 
Lawrence, KS 66046 
email: kelly@rdpub.com 



publications, inc. 
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Testing the Windows 
DOS Extender 

Walter Oney 


Windows offers many of the same features as a DOS extender: it loads your 
program into extended memory and intercepts any calls your program makes 
to DOS (via INT 21h), moving any parameters down to conventional memory 
(since DOS cannot access extended memory), executing the interrupt, and mov¬ 
ing the resulting data back up to extended memory. But how good an exten¬ 
der is Windows? Specifically, which INT 21h functions does Windows handle 
and how does that performance stack up against commercial DOS extenders 
like DOS/16M (whose continued development I managed for a time) from Ra¬ 
tional Systems or LITE286 from Phar Lap Software? I'll try to answer these 
questions in this article. 

I will describe a test program and the results of running it under DOS, Win¬ 
dows 3.1, Windows NT, a DOS box under Windows 3.1, and a DOS box under 
Windows NT. Since I didn't set out to do rigorous QA, I built what I call a 
'straight face" test. This kind of test asks, "Can you say with a straight face that 
a certain program operates correctly when used as intended in common 
ways?" In other words, you write a test program that exercises all of the com¬ 
monly used features of a program in normal ways and then see if the pro¬ 
grammer giggles (or perhaps cries) when presented with the test output. I've 
often used such tests as a criterion for an alpha-level software release, but it 
should be obvious that much more intensive investigation of boundary and 
incorrect-use cases is needed for later stages in a release cycle. Interestingly 
enough, straight-face tests disclose obvious and important mistakes often 
enough to be an important part of building software. 


Walter is a freelance developer and software consultant in Boston, MA. He specializes 
in system tools and in interfacing complex applications to Windows, NT, and DOS. He 
can be reached on CompuServe at 73730,553. 
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Figure 1 Etymology of test programs 


I21TEST.C 


—»■ I21TEST.0BJ 


—> I21TEST.W0B 
—» I21TEST.P0B 
—> I21TEST.X0B 



I21TEST.EXE [DOS, Windows & NTDOS boxes] 

121 TEST. EXP [DOS/16M in DOS, & DOS boxes] 
W21TEST.EXE [WinApp] 

P21TEST.EXE [PharLap in DOS & DOS boxes] 
X21TEST.EXE [DPMI in Windows & NT DOS boxes] 


AccuSoft Image Format Library 4.0 

Import • Export • Scanning • Conversion • Compression 
Display • Printing • Image-Processing • Special-Effects 


Fastest libraries on the market 
Guaranteed to read all images in existence 


WIN □ DOS □ VBX □ WIN-NT □ OS/2 □ UNIX □ MAC 
WIN-32 Pro Gold □ DOS-32 □ VBX-32 □ and others 


When your application demands high quality imaging and top 
performance, only AccuSoft can deliver. We are the leader in 
high-performance imaging solutions around the globe. 
AccuSoft provides the highest quality toolkits with a 
guarantee that can’t be touched! 


IPG 
T G A 
BMP 
WMF 
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• 12 formats supported with auto-detect 

• Fastest Group 3, Group 4 and JPEG available! 

• Non-standard G3 and G4 files also supported. 

• Scanning supported including TWAIN. 

• High-speed image display and printing. 

• Complete image processing including: 

Rotate, invert, resize, sharpen, blur, 

Roberts Cross, Matrix convolutions, 

Color reduction, edge detection, etc. 

• Incredibly easy high-level interface. 

• Low-level interface; read & write 1 line at a time. 

• All compression algorithms supported. 

• Custom versions available. 

• 30 day money-back guarantee for 16 bit products. 

Call now to order or for more details by fax. 


(800) 525-3577 

(508) 898-9662 (FAX) 

High Performance Imaging! 


GIF 
EPS 
WPG 
DIB 
PICT 


AccuSoft Corp. 112 Turnpike Rd. Westborough, MA 01581 (508) 898-2770 
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Suppose Windows does not sup¬ 
port a particular DOS function that 
your Windows application wants to 
access, in most cases, you should be 
able to use DPMI (DOS Protected- 
Mode Interface), a set of services de¬ 
signed to allow DOS extenders to co¬ 
exist with Windows. You can use 
DPMI function 31/0300 (simulate real¬ 
mode interrupt) to execute a DOS 
function in real mode. This may not 
always be easy, because certain op¬ 
erations require using the Windows 
API instead of INT 21h functions. For 
example, to allocate V86-mode mem¬ 
ory requires you to call Windows' 
GlobalDosAllocO because real-mode 
INT 21h, function 48h calls always fail 
in the system virtual machine. Factors 
like this make it helpful to know in 
advance what functions will work. 

Microsoft documents the INT 21h 
coverage of the built-in DOS extender 
in Chapter 20 of the Microsoft Win¬ 
dows Software Development Kit Pro¬ 
grammer's Reference, Volume 7: Over¬ 
view manual. The documentation 
isn't totally complete, however. For 
example, the manual implies that INT 
21h, function 09h (display string) 
should work, whereas that function 
prints character data on top of the 
graphical screen. Of more import is 
the fact that various undocumented 
but frequently used DOS functions 
don't work transparently within a 
Windows application, but some do, 
and the manual doesn't help you dis¬ 
tinguish. Finally, I often find it helpful 
to have an independent check of Mi¬ 
crosoft's Windows documentation: 
despite ever-improving quality, it still 
omits things I want to know and 
makes occasional mistakes. 

The Test Program 

The test program I used to investi¬ 
gate the Windows DOS Extender is 
named 121 TEST. It's over 2,000 lines 
of very boring C and inline assembler 
code, and neither the editors nor I 
thought you'd be interested in seeing 
all of its gory detail here in the 
magazine. There are some clever bits 
in 121 TEST that are worth discussing 
before we get to the actual results of 
testing DOS extenders, however. The 
complete code is on the code disk, 
available from a number of online 


Page 48 — Windows/DOS Developer’s Journal 


February 1994 



























sources listed in the table of con¬ 
tents. 

Not only did I want to test INT 21h 
calls from within a Windows applica¬ 
tion, but I also wanted to provide a 
comparison with several other envi¬ 
ronments. In addition, I wanted to 
minimize the amount of explicit con¬ 
ditional compilation spread through¬ 
out the test program. 

For reporting results, I just wanted 
to use regular runtime library rou¬ 
tines like printfO and putsO. Finally, 

I wanted to be able eventually to 
compile the selfsame code for the 
32-bit flat model without having to 
completely rewrite it; given the profu¬ 
sion of inline assembler, this poses a 
considerable challenge that I'm not 
sure I've met. 

Figure 1 diagrams the etymology 
of the test program. A single source 
file, i21test.c, generates i21test.obj 
(DOS and DOS/16M version), 
i21test.wob (Windows application ver¬ 
sion), i21test.pob (Phar Lap version), 
or i21test.xob (DPMI version). The ob¬ 
ject files in turn generate i21test.exe 
(DOS), i21test.exp (DOS/16M), 
w21test.exe (Windows application), 
p21test.exe (Phar Lap), and 
x21test.exe (DPMI). These five pro¬ 
grams will be run in appropriate test 
environments (DOS, Windows, Win¬ 
dows DOS box, and NT DOS box) to 
yield a total of twelve actual tests. 

Since there are significant differ¬ 
ences between running 121 TEST as a 
Windows application and running it 
as a DOS application, I elected to 
base some major compile-time deci¬ 
sions on the preprocessor variable 
_UIND0US. My makefile defines _HIN- 
DOUS when it builds the Windows ap¬ 
plication version and leaves it unde¬ 
fined when it builds all other ver¬ 
sions. Within i21test.c, I do the fol¬ 
lowing special things when _UIND0US 
is defined: 

• Include windows.h and one of my 
own files, named waltio.h, which 
defines the interface to a stream 
output DLL I built once upon a 
time. WALTIO provides printfO 
and putsO services in a scrolling 
window. The executable version 
of WALTIO is included with the 
code disk so you can run 121 TEST 
yourself. 


Figure 2 Code to check for protected mode 


{ 

mov isprotected, 1 
smsw ax 
test ax, 1 
jz noprotected 


// determine if in protected mode 
assume we're in protected mode 
is processor in real mode? 


Processor is in protected mode. We can’t tell by executing 
instructions if it's V86 mode, so check for being in "real" mode 
under a DPMI host. Note that there’s no check under VCPI, so 
we have to hope the VCPI host will honor 2F/1686 and 1687 anyway. 


mov ax, 1686h 


fen 1686: check processor mode 
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Figure 2 continued 

int 

2Fh 


test 

ax, ax 

; AX == 0 if protected mode under DPMI 

jz 

yesprotected 

: .. 

mov 

ax. 1687h 

; is a DPMI host active? 

int 

2Fh 

1 . . 

test 

ax, ax 

; AX == 0 if yes 

jnz 

yesprotected 

: if not, we’re really in protected mode 

noprotected: 


mov 

isprotected, 0 

: flag as real-mode program 

yesprotected: 


} 


// determine if in protected mode 


Listing 1 dpmiprot.asm — Protected-mode interface routine for DPMI 


DPMIPROT.ASM -• Protected-mode Interface routine for DPMI 

Copyright (0 1993 by Halter Oney 
All rights reserved 


name dpmiprot 
.model small, c 
.386 

byp equ <byte ptr> 
wp equ <word ptr> 
dwp equ <dword ptr> 

; Old-executable file header: 


exe_hdr 

struc 



ejagic 

dw 

0 

0 magic number: 5A4D (MZ) 

e_cblp 

dw 

0 

2 bytes in last record of file 

e_cp 

dw 

0 

4 # 512-byte records in file 

e_crlc 

dw 

0 

6 # fixups 

e_cparhdr 

dw 

0 

8 size of file header in paragraphs 

ejninalloc 

dw 

0 

A minimum extra paragraphs needed 

ejnaxalloc 

dw 

0 

C maximum extra paragraphs needed 

e_$s 

dw 

0 

E initial SS (relative) 

e_sp 

dw 

0 

10 initial SP 

e_csum 

dw 

0 

12 checksum 

e_ip 

dw 

0 

14 initial IP 

e_cs 

dw 

0 

16 initial CS (relative) 

ejfarlc 

dw 

0 

18 offset of fixup table 

e_ovno 

dw 

0 

1A overlay number 

e_res 

dw 

4 dup (0) 

e_oemid 

dw 

0 

24 OEM identifier 

e_oemi nf o 

dw 

0 

26 OEM information 

e_res2 

dw 

10 dup (0) 

ejfanew 

dd 

0 

3C offset of It/ft/... header 

exe_hdr 

ends 



emagic 

equ 

5A4Dh 

MZ signature 

emulator_data segment byte public ’data’ 


extrn _EmDataSeg:word 
emulator.data ends 


.data 

extrn _pgmptr:dword 
extrn _psp:word 
extrn _argviword 

toprot dd ? ; mode-switch routine 

dataseg dw ? ; real-mode DS 

codeseg dw ? ; real-mode CS 


• Omit the testing code for charac¬ 
ter I/O and FCB functions. I'll dis¬ 
cuss why later on. 

When jflNDOUS is undefined, on 
the other hand, a DOS application is 
being created. In that case, 121 TEST 
includes the regular stdio.h and de¬ 
fines macros named MAKELPO, SELEC- 
TOROFO, and OFFSETOFf) for manipulat¬ 
ing 16:16 far pointers. 

Checking for Protected 
Mode 

In order to verify some of the INT 
21h functions, it is necessary to decide 
whether a given pointer is valid or 
not. For example, INT 21h, function 
38h and INT 21h, function 6501h both 
return localization information that 
includes a far pointer to a function 
that you can call to convert an inter¬ 
national character to upper case. In 
protected mode, you don't want to 
call through this function pointer un¬ 
less it is a valid protected-mode 
pointer. In real mode, however, no 
validation is possible or necessary. 
121 TEST therefore investigates its en¬ 
vironment at the very beginning to 
see if it is running in real or pro¬ 
tected mode. The code which does 
this is shown in Figure 2. 

The protected-mode check begins 
with the SMSU instruction. This instruc¬ 
tion was originally implemented for 
the Intel 80286 chip in order to cap¬ 
ture the Machine Status Word, whose 
low-order bit (the PE bit) is 1 if the 
processor is in protected mode. The 
80386 and later processors have a 
32-bit control register (CRO) which is 
a superset of the MSW, and they of¬ 
fer the instruction 

MOV EAX, CR0 

to capture its contents. The 80386 
MOV instruction is privileged, however, 
and can only be executed by a ring 0 
program. We wouldn't want to GP 
fault at the very beginning of the test 
program if we were running as a ring 
3 Windows application, of course. 
Luckily, the SMSU instruction is not 
privileged and is supported for com¬ 
patibility reasons by the 80386 and 
later processors, so it is safe to use in 
this context. 
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If the PE bit is 0, we can be sure 
we're running in real mode. Unfortu¬ 
nately, the converse isn't true. The 
virtuai-8086 (V86) mode of an 80386 
is a kind of protected mode, and the 
PE bit will be 7. V86 mode is indi¬ 
cated by a bit in the EFLAGS register, 
but the Intel processor always clears 
that bit when it stores the flags. 

Therefore, there's no way an instruc¬ 
tion sequence can distinguish be¬ 
tween being in V86 mode or regular 
protected mode. I think that this is an 
unfortunate design flaw in the Intel 
chips, because there are times (such 
as this test program) when you need 
to know. 

A partial solution to the ambiguity 
of the PE bit is possible if system soft¬ 
ware supports the INT 2Fh calls asso¬ 
ciated with the DOS Protected Mode 
Interface (DPMI). INT 2F, function 
1686h will clear the AX register if 
you're running in DPMI protected 
mode. Once 121 TEST sees that the PE 
bit is on and that the processor is 
therefore in some kind of protected 
mode, it calls INT 2F, function 1686h. If 
AX comes back zero, the program 
must be in protected mode. If AX is 
not zero, however, you have to make more tests. If a 
DPMI host is actually present (indicated by the return from 
INT 2F, function 1687h), then the code must be in V86 
mode and subsequent pointer checks should take the real¬ 
mode path. If a DPMI host is not present, the code might 
still be in V86 mode under control of a VCPI host or other 
memory manager. VCPI doesn't provide a way to distin¬ 
guish between V86 and protected mode, though, so you 
are pretty much stuck at this point. Many modern VCPI 
memory managers (such as 386 A Max and QEMM) also 
support the DPMI INT 2Fh calls, so the code might not get 
this far. Microsoft's EMM386 doesn't support the calls, 
however. As a result, 121 TEST fails miserably when run in 
V86 mode under EMM386, because it incorrectly con¬ 
cludes that it is in protected mode. 

Running under DPMI 

There are two protected-mode environments in Win¬ 
dows 3.1. Windows applications run as protected-mode 
programs in the system virtual machine along with all 
other Windows applications, u21test.exe performs the INT 
21 h tests in this case. The other environment exists in a 
DOS box if you use DPMI services to create a protected- 
mode application. 

Commercial DOS extenders use DPMI in order to run 
programs in protected mode, and they provide a great 
many other services too. For purposes of the tests described 
in this article, I wanted a protected-mode DPMI environment 


Listing 1 continued 

hostdata dw 

0 

host data area 

exehdr db 

512 dup (?) 

header of .EXE file 

.code 



toprotected proc uses si di 


; Get the DPMI protected-mode switch entry point 

mov 

ax, 1687h 

get DPMI switch address 

int 

2Fh 


test 

ax, ax 

is DPMI active? 

jnz 

fail 

if not, return FALSE 

mov 

wp toprot, di 

save switch addr 

mov 

wp toprot+2, es 


mov 

bx. si 

BX = # paras for host 

; Reserve memory for the switch to protected mode 

test 

bx. bx 

any memory needed? 

jz 

short nohostmem 

if not. skip ahead 

mov 

ah, 48h 

yes. get memory 

int 

21h 


jc 

fail 

die if can’t get it 

mov 

hostdata, ax 

save host data area seg 

nohostmem: 



; Read the header for this .EXE file. Assume all fixups will be in 

; first 512 bytes and a bunch of other things that may not always be 

: true. 



mov 

bx. _argv 

BX -> argv vector 

mov 

dx, wp [bx] 

DSrDX -> argv[0] 

mov 

ax. 3D00h 

fen 3D: open file 
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Listing 1 continued 


int 21h 

try to open our .EXE 

jc fail 

die if we can’t 

mov bx, ax 

copy file handle 

mov cx, 512 

read 512 bytes 

mov dx, offset exehdr 


mov ah, 3Fh 


int 21h 


jc fail 

die if we can't 

mov ah, 3Eh 

close the file 

int 21h 


mov dataseg, ds 

save real-mode DS 4 CS 

mov codeseg, cs 


; Switch to protected mode 

xor ax. ax 

we’re a 16-bit client 

mov es, hostdata 

ES -> host data area 

call [toprot] 

try to switch 

jc fail 

die if we can’t 

; Change real-mode segment values to selectors 

mov _psp, es 

change _psp to selector 

mov ax, 000Ah 

fen 000A: create alias 

mov bx, cs 

BX * selector 

int 31h 

get alias (in AX) 

mov es, ax 

ES is now data alias 

mov cx, exehdr.exe hdr.e crlc 

CX = # fixups in .EXE 

mov bx, exehdr.exe hdr.e lfarlc 

BX -> fixup table 

add bx, offset exehdr 


nextfixup: 

cmp wp [bx+2], 0 

fixup for code segment? 

jne short skipfixup 

if not, skip it 

mov si, wp [bx] 

ES:SI -> fixup in CS 

mov ax, codeseg 

fixup to code segment? 

cmp ax, wp es:[si] 


mov ax. cs 


je short changefixup 

if yes, skip ahead 

mov ax, dataseg 

fixup to data segment? 

cmp ax, wp es:[si] 


mov ax, ds 


jne short skipfixup 

if neither, punt 

changefixup: 

mov wp es:[si], ax 

change fixup to sel 

skipfixup: 

add bx, 4 

up to next fixup 

loop nextfixup 

do all of them 

mov ax, 0001h 

fen 0001: cancel sel 

mov bx. es 

BX = selector to cancel 

xor cx. cx 

(host should clear ES 

mov es. cx 

ES, but be sure) 

int 31h 

cancel alias selector 

success: 

mov ax, 1 

indicate success 

ret 

return to caller 

fail: 

xor ax. ax 

indicate failure 

ret 

return to caller 

toprotected endp 

end 

: End of File 


that did not include any other DOS 
extender. That turns out to be fairly 
easy to achieve. 

dpmiprot.asm (Listing 1) is a bare- 
bones (and not very robust!) routine 
for converting a real-mode program 
into a protected-mode client under 
DPMI. The basic operation of switch¬ 
ing to protected mode is accom¬ 
plished by calling a function whose 
address you derive from INT 2Fh, 
function 1687h. Since the test program 
contains several segment fixups, 
however, it is important to then re¬ 
place the real-mode paragraph num¬ 
bers in the executable image with 
the corresponding protected-mode 
selectors. 

In order to relocate the program 
for protected mode, I read the fixup 
table from the .exe file into memory 
before switching to protected mode. I 
made some rash assumptions about 
how large the fixup table could be 
because I was mostly interested in 
getting this one test program to 
work. After the switch to protected 
mode, I then scan for fixups in seg¬ 
ment 0, which will be the code seg¬ 
ment in a Microsoft C .exe image. As¬ 
suming that each fixup is either to 
the single code segment (this being a 
small-model program, after all) or to 
DGROUP, I replace the real-mode para¬ 
graph number at each fixup location 
with either the code or data selector 
established by DPMI. In addition, I re¬ 
locate the _psp global variable to con¬ 
tain the selector for the PSP (DOS 
Program Segment Prefix). 

It's important to note that DPMI- 
PROT is a long way from being a 
general purpose program for convert¬ 
ing a real-mode program to pro¬ 
tected mode. There are other point¬ 
ers that should be relocated. For ex¬ 
ample, the floating-point emulator re¬ 
lies on a DGROUP pointer in its EMULA- 
TOR_DATA segment. DPMIPROT as¬ 
sumes it's part of a small-model Mi¬ 
crosoft-generated program and that 
no far pointers occur in static data. 
This is a very fragile routine that will 
probably require care if I make 
changes to the INT 21h test. 

Test Results 

To establish a baseline against 
which to compare all other tests, I 
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ran i21test.exe under DOS 5 with no DPMI or VCPI mem¬ 
ory manager present. I also had SHARE installed so that 
the test of file locking (INT 21h, function 5Ch) would poten¬ 
tially work. Figure 3 contains the output from this baseline 
test. Refer to the table at the end of the figure and notice 
that most (but not ail) functions of INT 21h are exercised. 
Most of the untested functions are undocumented, but 
some undocumented functions (such as INT 21h, function 
52h for locating the so-called 'List of Lists') are so fre¬ 
quently used that I included tests for them. 

The various tests inside Windows used the April 1992 
retail release of Windows 3.1. NT tests were run under the 
July 1993 retail release. I used 
DOS/16M version 5 and LITE286 ver¬ 
sion 3.0 for the commercial DOS ex¬ 
tender tests. 

Table 1 summarizes the test re¬ 
sults for all platforms and environ¬ 
ments. A detailed discussion follows. 

Character I/O Functions 

This category includes the low- 
numbered functions 01h through 0Ch, 
used for direct console, printer, and 
serial I/O. I didn't test the serial func¬ 
tions ( 03h and 04h)- using these func¬ 
tions from within a Windows applica¬ 
tion isn't helpful because they bypass 
ail of the Windows event queues and 
output mechanisms. You can, for ex¬ 
ample, use INT 21h, function 09h to 
display a string, but the output first 
overwrites and then gets overwritten 
by the Windows graphical screen. 

The only anomaly I found was with 
the native DPMI test (X21TEST) in an 
NT DOS box. INT 21h, function 06h (di¬ 
rect console read) kept writing blanks 
to the screen while it was waiting for 
me to type characters. 

FCB Functions 

Before DOS v2.x came along with 
a hierarchical file system, disk file I/O 
relied on a data structure called a File 
Control Block (FCB). The INT 21h func¬ 
tions that use FCBs are seldom (per¬ 
haps never?) used any more because 
a more complete set of file-handle 
functions is available. As much as Mi¬ 
crosoft might wish to kill these func¬ 
tions off, it can't quite seem to do so 
without losing backward compatibil¬ 
ity. The Windows SDK documenta¬ 
tion advertises that these functions 
aren't supported within a Windows 
application, so I didn't try to call 
them. They worked fine in the V86- 
mode DOS boxes of Windows and 


NT, but I had mixed results with the extended-DOS tests. 
Rational Systems' DOS/16M handled most of the FCB 
functions okay but failed to correctly write a disk file; I 
didn't track the problem to its source, but it might be that 
someone in the C8 runtime library or in the DOS extender 
isn't preserving the Disk Transfer Area (DTA) address 
through all of the DOS calls that occur within the test pro¬ 
gram. The DPMI test (X21TEST) gave the same results as 
DOS/16M in a Windows DOS box, but it induced 'FCB Un¬ 
available' critical errors when run under NT. Phar Lap's 
LITE286 failed all FCB calls except INT 21h, function 29h 
(parse filename). 
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File Handle Functions 

This category of functions in¬ 
cludes all of those normally used for 
manipulating disk files under DOS. I 
didn't find it surprising that all of 
these functions worked correctly in 
the Windows application test and in 
the DPMI tests under both Windows 
and NT. DOS/16M didn't understand 
INT 21h, function 6Ch (extended file 
open), but LITE286 handled it cor¬ 
rectly. Interestingly, INT 21h, function 
5Ch (lock region of file) operates un¬ 
der NT even though SHARE isn't ex¬ 
plicitly loaded; NT evidently encom¬ 
passes the interlocking functions of 
SHARE by default. 

The commercial DOS extenders 
failed one of my tests of INT 21h, 
function 44h (I/O control). I tested INT 
21h, function 4400h (get device infor¬ 
mation) on an opened disk file be¬ 
fore I did any writes to the file han¬ 
dle. All environments correctly re¬ 
ported the disk drive on which the 
file was allocated. In all DOS environ¬ 
ments, I got the expected answer 
that the file had not yet been written. 
Under NT, however, I was told that 
the file had been written. I'm not sure how to interpret the 
result under NT, but it's counterintuitive. I also used INT 
21h, function 440Ch, subfunction 0565h (get iteration count) 
to determine the iteration count for the DOS STDPRN de¬ 
vice (handle 4). The significance of the test is that it re¬ 
quires DS:DX to point to a data buffer. Since not all INT 21h, 
function 44h subfunctions use a data buffer, or even use 
the same registers to hold a pointer if they do use a data 
buffer, a DOS extender has to be extra careful when pass¬ 
ing INT 21h, function 44h calls down to real mode. Win¬ 
dows and NT handled this call correctly, both when done 
from a Windows application and when done from the raw 
DPMI-extended X21TEST test program. For some reason, 
the answer was '80' in every case except the NT Win¬ 
dows application and DPMI tests, where it was "2'; I con¬ 
fess to not understanding what importance to attach to 
this difference. Both DOS/16M and LITE286 failed the call, 
however, indicating that they didn't understand how to 
handle this particular subfunction. 

Disk Management Functions 

I tested a number of functions used for querying and 
setting information about disk drives. All of the docu¬ 
mented functions in this class worked correctly in all envi¬ 
ronments. The undocumented INT 21h, function 6900h (get 
disk label) didn't uniformly work, however. This function is 
potentially useful as a way of determining the volume la¬ 
bel, serial number, and type of file system employed on a 
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Figure 3 Output from DOS extender testing program 


INT 21 Test Program Version 1.0 
Copyright (C) 1993 by Walter Oney 
All rights reserved 

Processor is in real mode; Windows is not active. 


Testing character I/O functions 

Enter a string ending in [Enter]:abc 
Read 3 characters: ’abc’ 

Enter another string ending in [Enter]:def 
Please type a CTRL-C: 

Read 03 

Enter yet another string ending in [Enter]:ghi 
And yet again (the 1st character will be discarded):kl 
Read 2 bytes: ’kl’ 

One last time:mno 
Read 3 bytes: ’mno’ 


Testing FCB functions 

21/29 correctly parsed FOO.BAR into FCB 
21/0F correctly failed to open FOO.BAR 
21/16 created FOO.BAR okay 
21/15 wrote 4 data blocks to FOO.BAR 
21/22 wrote 1 data block to FOO.BAR 
21/28 wrote 2 data blocks to FOO.BAR 
21/10 closed FOO.BAR 
21/11 found FOO.BAR 

21/12 correctly found no more matches for FOO.BAR 

21/23 correctly reports that FOO.BAR has 7 128-byte records 

21/17 renamed FOO.BAR to BARF.FIL okay 

21/0F opened BARF.FIL okay 

21/21 read 1 block from BARF.FIL correctly 
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disk volume. It returns incorrect re¬ 
sults when called from a Windows 
application or from either DOS/16M 
or LITE286. Curiously, this function 
worked correctly in the X21TEST 
(DPMI) test under Windows 3.1 (even 
though you'd think exactly the same 
DOS extender was involved as in the 
Windows application case) but not 
under NT. 

Time and Date Functions 

There are four functions for query¬ 
ing and changing the system clock. 
NT doesn't allow you to change the 
system date but does permit a time 
change. This makes some sense, I 
suppose, if you think about changing 
time zones or accommodating day¬ 
light savings time. I tested INT 21h, 
function 2Dh (change time) by chang¬ 
ing the time to 01:02:03.04 and then 
reading back the time to see if it's 
still 01:02:03. For some reason, 
DOS/16M didn't pass this test in a 
Windows DOS box, but did handle it 
correctly outside of Windows. 


Figure 3 continued 


21/27 read 2 data blocks from BARF.FIL 
21/13 deleted BARF.FIL 


Testing file handle functions 

21/30 correctly reported that ’C:\OUNK\I21TEST\FOO.BAR’ doesn’t exist 
21/3C created file 'C:\JUNK\I21TEST\F00.BAR' 

21/4400 reports that C:\OUNK\I21TEST\FOO.BAR is on drive C. has not been written 
21/440C reports that STDPRN iteration count is 80 
21/40 wrote data to file okay 
21/42 repositioned file to beginning 
ile to beginning 
21/3F read file data back ok 
21/68 claims to have comitted data to file 
21/5C claims to have locked region 0000-0200 of file 
(region was in fact locked) 

21/57 reports file date is 09/19/93 20:49:58 
21/3E closed file ok 

21/56 claims to have renamed ’C:\JUNK\I21TEST\FOO.BAR’ to ’C:\JUNK\I21TEST\BARF.FIL’ 
21/43 reports attribute for ’C:\0UNK\I21TEST\BARF.F1L' to be 20 
21/45 duplicated STDPRN handle okay 
21/46 redirected STDPRN okay If you see this message 
21/4E found: BARF.FIL, attr 20, length 24, 09/19/93 20:49:58 
21/4F correctly reported no more matches for ’C:\JUNK\I21TEST\BARF.FIL’ 
21/59 reports following extended error information: 
code 0012 

class 8 (file/item not found) 
action 18 (?) 
locus 1 (unknown) 

21/41 claims to have deleted ’C:\JUNK\I21TEST\BARF.FIL’ 

(file was. in fact, deleted) 

21/5A created temporary file ’C:\JUNK\I21TEST\BEDCAAAP'. handle 5 
21/5B correctly refused to create existing file 'C:\JUNK\I21TEST\BEDCAAAP' 
21/6C opened ’C:\JUNK\I21TEST\BEDCAAAP’ okay, returned handle 5 
(correctly reported file existed and was opened) 


Want to get the source code for 
the Borland 3D Chart Control? 


ToolsKan 


Visual Basic Toolkit $99 


For SDK & Visual Basic 
3D Chart 

- Over 30 of 2D & 3D chart styles 

- Rotation & scrolling 

- Supports printing & clipboard 

Toolbox 

- Creates buttons from bitmaps 
or text 

* Supports scrolling 

- 3D buttons w/ color customization 

- Single/multiple/no-state button 
groups 

Ribbon 

- 3D items with color customization 

- Supports combobox, text, & buttons 

Field Validation 

- Validates date, time, number fields 
& "PIC" statements 

Meter 

- Creates vertical, horizontal, & 
circular gauges with choice of 
needle or color bar as indicators 

- Linear & logarithmic scales 

Table 

- Column & row split windows 

- Multiple row & column selections 

- Check boxes/radio buttons/bitmaps/ 
editable/combobox column 

- Input validation 

- Color customization 

Status Bar 

- Auto scrolled text 

- Stretchable field width 

- Colored progress bar 

- Show date, time, & key states 


Windows SDK Bundle $199 

$199 SDK DLL Bundle includes Table, Toolbox, 
Status Bar, Ribbon, Field Validation & Meter. 



Consulting & 

Contract Programming Available 


Free Demo from BBS. 

No Royalties. 30-day MBG. 
Optional with source code. 


Tel: (408) 263-9881 
Fax: (408) 263-9883 
BBS: (408) 263-0892 


Kansmen Corporation 
P.O. Box 360070 
Milpitas, California 95036 
USA 
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Developer's Toolkit 



Fastest, Most Powerful Text 
Retrieval Technoljogy Available 


Based on ZylNDEX—leader from the beginning . 
in PC text retrieval 



• Search 1 GB in Less Than 5 Seconds 

• Up to SO Million Documents, 10 GB Total Per Index 

• Powerful Searches: Word, Phrase, Proximity, Boolean, 

Wild Cards and More 

• Works Directly with MS Word, WordPerfect, AmiPro, 

dBASE, ASCII, and Others 

Ideal for use with high-level application development 
environments such as Visual Basic, ToolBook, 
KnowledgePro, and ObjectVision. 


Windows, DOS, and UNIX/386 ZvLAB 
libraries available $3,995 
... , 

Call for Specs and Demo. 

100 Lexington Drive • Buffalo Grove, IL 60089 
Phone: (708) 459-8000 • Fax (708) 459-8054 
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Figure 3 continued 


Testing disk Management functions 

The current default disk drive is 'C:' 

21/0E succeeded in changing current drive to A: 

Current disk info: media id byte F8. 

8 sectors of size 612 for each of 59518 clusters 
Info for disk C: media id byte F8, 

8 sectors of size 512 for each of 59518 clusters 
Current disk has 16287872 free bytes 
Verify flag is now off 
Verify flag changed okay with 21/2E 
21/69 reports info level 14915, disk serial 13FB-373F 
label 'NO NAME file system type 'FAT16 ’ 




A Total Forms Processing Tool Kit 


AutoData SDK" 

Windows 3.1 DLL 


Hand-Printed • Mark Sense 
OCR • Bar Code Recognition 


Stock Requisition -| 


Bar Code 
for product number, 
territory code, form ID, etc. 


OCR (Type Print) 
for preprinted job code, 
order number, form ID, etc. 


Mark Sense- 
for multiple choice, 
rating, true/false, etc. 
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rrm cn 
rrm cn 
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I DRIVE CONTROLLER I 


II 


Id 61/11151/19131 
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MCR (Hand-Printed) 
for name, address, date 
time, dollars and cents, 
• phone numbers, etc. 


Image Capture 
for signatures, 
pictures, drawings, etc. 


Empower Your Software To Read 

The AutoData SDK II Software Developers Kit provides 
state-of-the-art recognition and imaging tools to 
automate data entry from scanned or faxed forms. 



S Y S T E M S 

A Unit of Electro-Sensors, Inc. 


AutoData Systems 

10365 West 70th Street • Eden Prairie, MN 55344-3446 
Phone: 612/941-8180 • FAX: 612/941-7312 

Toll Free: 800/662-2192 


□ Request 166 on Reader Service Card □ 


Directory Operations 

Directory operations include creat¬ 
ing and deleting directories as well as 
changing the current directory. These 
operations worked correctly in all en¬ 
vironments. I did discover, somewhat 
by accident, that, when running un¬ 
der CodeView, my current directory is 
the compiler's BIN subdirectory rather 
than something more directly tied to 
the application I'm debugging. I also 
included a test of the undocumented 
INT 21h, function 60h (canonicalize 
pathname). Neither Windows nor the 
commercial extenders dealt with it 
correctly. DOS/16M came closest, but 
it unaccountably put 51 hyphens in 
front of the canonicaiized name it re¬ 
turned. 

Process Management 
Functions 

There are two functions for deter¬ 
mining the current Program Segment 
Prefix (PSP). The documented INT 21h, 
function 62h worked as expected in 
all cases. In protected-mode environ¬ 
ments, it returned a protected-mode 
selector which matched the ES regis¬ 
ter passed into the C startup routine 
by the surrounding operating envi¬ 
ronment. The undocumented INT 21h, 
function 51h also worked correctly, 
but it returned the real-mode PSP 
paragraph address under DOS/16M. 
DOS/16M's handling is actually pref¬ 
erable in some ways because you 
often want to use INT 21h, function 
51h in conjunction with undocu¬ 
mented INT 21h, function 50h (set PSP) 
in order to change PSPs, and you 
most often want to use real-mode 
paragraph numbers for both pur¬ 
poses. If you're programming a pro¬ 
tected-mode TSR, for example, you 
need to switch to your own PSP 
when you wake up and you neither 
have nor want a selector that 
matches the real-mode PSP which 
was active when you woke up. INT 
21 h, function 26h (create PSP) is both 
dangerous in some environments 
(e.g., DOS/l 6M) and obsolete, so I 
didn't test it. 

INT 21h, function 4Bh (execute pro¬ 
gram) highlights one major difference 
between the DOS and Windows ap¬ 
plication environments. I used INT 
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21h, function 4Bh to launch a small 
program that exited with a return 
code of 42. In the DOS and ex- 
tended-DOS world, this is a synchro¬ 
nous function that doesn't return un¬ 
til the spawned application termi¬ 
nates. You can then use INT 21h, 
function 4Dh to get the exit code. In 
Windows, however, INT 21h, function 
4Bh actually gets trapped by the Win¬ 
dows kernel in order to create a DOS 
virtual machine that runs asynchro¬ 
nously with the caller. That is, INT 
21h, function 4Bh returns after launch¬ 
ing the target program but does not 
wait for the target program to termi¬ 
nate. A subsequent call to INT 21h, 
function 4Dh will retrieve some non¬ 
sense value that almost surely has 
nothing to do with the program you 
were spawning. In fact, INT 21h, func¬ 
tion 4Dh could never give you the 
right results because it executes in 
the system virtual machine rather 
than the virtual machine in which the 
target program ran. Note that the 
UinExecO turns into an INT 21h, func¬ 
tion 4Bh at a low level, so it will also 
have the same behavior. (A tech¬ 
nique for getting the return code 
from a spawned program is de¬ 
scribed in my article 'Parlez-Vous 
Windows?' in the April 1992 issue of 
Windows Tech Journal.) 

These details about INT 21h, func¬ 
tion 4Bh and INT 21h, function 4Dh are 
irrelevant under Phar Lap's LITE286, 
unfortunately. LITE286 simply fails 
the call to INT 21h, function 4Bh, mak¬ 
ing it impossible to spawn a program 
in that environment. 

Memory Management 
Functions 

In real-mode DOS, you can use INT 
21h functions to allocate, reallocate, 
and release memory segments. 
These functions also work analo¬ 
gously in the protected-mode envi¬ 
ronments, with the obvious exception 
that they deal in segment selectors 
instead of paragraph numbers. You 
should not expect a protected-mode 
call to INT 21h, function 48h (allocate 
memory) to give you memory in the 
lower megabyte, by the way; it may 
(and often should) allocate extended 
memory. 


Figure 3 continued 


Testing time and date functions 

21/2A reports today is Sunday. September 19, 1993 
21/2B correctly changed date to Thursday, January 2. 1992 
21/2C reports it's now 28:58:88.15 
21/2D correctly changed time to 81:82:03 


Testing directory operations 

21/47 reports current directory is ’JUNKM21TEST' 

21/39 successfully created subdirectory 'BARFOLA' 

21/3B claims to have changed to subdirectory 'BARFOLA' 

(Current directory was in fact changed OK.) 

21/3A successfully deleted subdirectory 'BARFOLA' 

21/68 converted 7aBc*.jnk’ to canonical form 'C:\ABC?????.JNK’ 


Testing process management functions 

21/62 reports PSP at 23E5, which agrees with ’_psp’ 
21/51 reports PSP at 23E5, which agrees with '_psp' 
21/4B of F0RTYIK0.EXE returned expected 802A 


Testing memory management functions 

21/48 allocated 512 bytes at 3788 
21/4A claims to have resized block to 256 bytes 
(block is in fact 256 bytes in size) 

21/49 claims to have released memory block 
21/5800 reports memory strategy is 00 (first fit. low) 
21/5802 reports UMBs are not in DOS memory chain 


Testing miscellaneous system functions 

DOS version is 5.00: OEM id 80; user serial 008080 
INT 60 handler reached okay, so 21/25 must have worked 
Done testing 21/25 and 21/35 
21/3300 reports BREAK flag is OFF 
21/3305 reports boot drive was C 

21/3306 reports that true DOS version is 5.00, rev 3, not in ROM, in HMA 
21/34 reports that INDOS flag is at 0116:0321 
21/3700 reports that 'switch' character is 7" 

21/38 reports that: 

date model is MM-OO-YY 

time model (1 minute after 6 PM) is 05:01:00 
currency model is J0.000.00 
data list model is 'data,data' 
upper case of " is ” 

21/52 reports 'list of lists' at 0116:0026 
21/6501 reports that: 
country ID is 1 
active code page is 437 
date model is MM-DD-YY 

time model (1 minute after 5 PM) is 05:01:00 
currency model is $0,000.00 
data list model is 'data,data' 
upper case of ” is ” 

21/6502 reports that uppercase table is at 0116:0AAD 
21/6504 reports that filename uppercase table is at 0116:0B2F 
21/6506 reports that collating table is at 0116:0BE1 
21/6507 reports that DBCS table is at 0116:0CE3 
21/66 reports current code page is 437, default is 437 
21/67 claims to have increased file handle count to 21 
(handle count was in fact increased) 


Testing network functions 

21/5E reports that local computer name is ’ 


Report of test coverage: 

0123456789ABCDEF 
0 - X X - • X X X X X X X X - X X 
1XXXXXXXX -XXXX - - - 

2 - X X X X X - X X X X X X X X X 

3 X - - X X X X X X X X X X X X X 

4 X X X X X X X X X X X X X X X X 
5-XX-X-XXXXXXX-X- 
6 X - X - - X X X X X • • X • - - 
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Miscellaneous System Functions 

I lumped every other INT 21h function into this catch¬ 
all. It's vaguely interesting that NT's I NT 21h, function 30h 
function reports a DOS version of 5.0, while undocu¬ 
mented I NT 21 h, function 3306h (get true DOS version) re¬ 
ports version 5.50 instead. My Windows application got 


an error code of 8 (insufficient memory) when it used INT 
21 h, function 67h to increase the file handle count from 20 
to 21, presumably because real-mode memory was 
needed but unavailable in the system virtual machine. In 
Windows, you could always call SetHandleCountO if you 
knew you were a Windows application. All of the DOS 


Table 1 Results of INT 21 h tests in all environments 
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extenders seem to understand INT 21h, function 34h (get 
address of INDOS flag) and INT 21h, function 52h (get 'List 
of Lists'), which is good news for TSR writers and examin¬ 
ers of DOS memory chains. 

I found considerable variation in the handling of INT 
21h, function 38h (get country information) and INT 21h, 


function 6501h (get extended country information). Both 
functions return a pointer to an upper-case function. Only 
DOS/16M changed this to a protected-mode pointer. INT 
21h, function 6501h, function 6502h, 6504h, 6506h, and 6507h 
also return pointers to case-conversion and sorting tables. 
Here, DOS/16M returned protected-mode pointers, but the 


Table 1 continued 
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NT Windows application and DPMI tests did too. LITE286 
actually failed the calls with an error code of 1 (invalid 
function), whereas the DPMI test using X21TEST under 
Windows 3.1 just reported the real-mode pointers. 

Conclusion 

The main thing I discovered by running these tests is 
that the Windows built-in DOS extender pretty much lets 
you use all the DOS functions you need for normal pro¬ 
gramming. This is probably on purpose: Microsoft prob¬ 
ably wanted to use most of its DOS runtime library code 
as-is, and the only way to accomplish that was to support 
the INT 21h calls made by runtime library functions. As a 
side effect, it's also possible for a protected-mode DPMI 
client in a DOS box to use the same INT 21h functions. 

The functional coverage of the built-in DOS extender is 
so good, in fact, that you might wonder why you'd ever 
need a commercial DOS extender. A commercial extender 
does lots more than just translate INT 21h calls. It loads 
programs into extended memory and makes sure that all 
far pointers use protected-mode selectors instead of real¬ 
mode paragraphs. Since DOS-based runtime libraries con¬ 
tain isolated routines that crash in protected mode, the 
commercial extenders usually also offer replacement li¬ 
braries. In addition, these extenders include functions for 
simplifying common tasks such as allocating memory, ma¬ 
nipulating selectors, and so on. They deal with other soft¬ 
ware interrupts (such as INT 10h for accessing the video 
BIOS or INT 33h for interacting with the mouse) that are 


part of robust PC applications. Finally, they usually also 
include development tools such as debuggers and linkers 
to facilitate development. 

Therefore, you'll still need a commercial DOS extender 
if you're developing a DOS program with significant func¬ 
tionality. You may need to verify for yourself the correct 
operation of any DOS interrupts you need to use, though, 
because my testing illustrates that coverage is spotty in 
some significant respects. If, on the other hand, all you 
want to do is deal with DOS from a Windows program, 
you may find from reading this article that the INT 21h 
functions you need are supported by Windows itself. □ 
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articles related to Windows NT, 
Win32s, and the Win32 API. If you 
have an idea for a related story and 
experience that would especially qualify 


Windows™/DOS Developer’s Journal 

Call For Papers 

you to write on one of these topics, 
contact our editorial staff for Author 
Guidelines at: 

Windows/DOS Developer’s Journal 

1601 West 23rd St., Suite 200 
Lawrence, KS 66046-2743 
(913) 841-1631; FAX (913) 841-2624 


Proposals should include a short ab¬ 
stract, preferably followed by a one- 
page outline of the article. A brief re¬ 
sume of the author’s qualifications 
should accompany the proposal. 


Debugging 

■ Proposals due 2/4/94 
manuscripts due 3/15/94 

Suggested topics: Using the Win¬ 
dows NT debugging interface. Tips 
and tricks for using Windows’ debug¬ 
ging output functions. A DLL that 
graphs debugging events. 


Software Tools 

■ Proposals due 3/4/94 
manuscripts due 4/15/94 

Transforming C++ source code into a 
browsable, cross-referenced WinHelp 
file. A profiler to perform test cover¬ 
age analysis of Windows programs. 
A utility to profile application resource 
loading to locate redundant loads, 
unused resources, etc. How to en¬ 
crypt .res file resources and decrypt 
them dynamically at runtime via 
SetResourceHandlerQ. 
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Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks —those 
clever pieces of code to 
make things work the 
way they should! You'll 
receive at least $50 for 
each tip that we print 
Send your submissions to.- 
Tech Tips 
Leor Zolman 
74 Marblehead Street 
North Reading, MA 01864 
leor@bdsoft.com. 


Yet Another Previous Instance and 
Trapping Parameter Validation Errors 


Revenge of the Son of Return to Previous Instance 


James K. Lawless 
2414 4th Ave 
Council Bluffs, IA 51501 


In the July issue of Windows/DOS Developer's Journal, I demon¬ 
strated a quick technique for reviving a previous instance of a Windows appli¬ 
cation with a shorter method than had been presented by another author. 

Well, it had to happen. I found what I believe to be absolutely the shortest 
solution to the problem. 

The code I presented in the prior column is an adapted form of Charles 
Petzold's Windows 'hello' program. To solve the problem more readily, I re¬ 
moved all the logic that checks for a previous instance of the program. 

I then added the following line: 

char_based (_segname("MYSEG"))raychar; 

This causes the linker to generate an extra data segment reference. Since only 
a single instance of a program with multiple data segments can run at a given 
time, Windows itself wakes up the original program! 

Please note that this is entirely automatic. To use this technique, you need 
only to add the data definition. No procedural code, API calls, or Window- 
search mechanisms are required. 

Listing 1 is the new version of whello.c; Listing 2 is the module definition 
file; and Listing 3 is a Microsoft C make file. 

Scott A. Mintz submitted an even shorter line of code to force the creation of a 
second data segment for a Windows app: 

int far nFoo; 

Scott also brought up the significant point that this technique applies only to Win!6 
and not to Win32, as there is no notion of"segments ' in Win32. 

This is absolutely, positively the last tip along this thread I am going to print! -iz 



Leor Zolman wrote BDS C, the first C compiler targeted exclusively for personal com¬ 
puters. Leor is currently an instructor on UNIX topics for Boston University's Corporate 
Education Center, a regular contributor to Sys Admin magazine and "Tech Tips" editor 
for Windows/DOS Developer's Journal. His first book, Illustrated C, was published 
by R9D Publications, Inc. in 1992. He may be contacted at 74 Marblehead St, North 
Reading, MA 01864, or on Usenet/Internet as: leor@bdsoft.com 



















Listing 1 whello.c 


/* 

* whello.c 

* 

* James K. Lawless 

* 2414 4th Ave 

* Council Bluffs. IA 51501 

* 

* This code is in reference to my own code in 

* a Tech Tip in the July 1993 issue of 

* Windows/DOS Developer’s Journal. 

*/ 


//include <windows.h> 

LONG FAR PASCAL WndProct HWND,WORD,WPARAM,LPARAM); 


char _basedC_segnameC"MYSEG”)) mychar; 


int PASCAL WinMainCHINSTANCE hlnstance. 

HINSTANCE hPrevInstance, 

LPSTR IpszCmdParam, int nCmdShow) 


{ 


LPSTR 1pszClass="Hel 1 oWin Again"; 
MSG msg; 

WNDCLASS wndclass; 

HWND hWnd; 

WORD CSVal; 
char txtbuf[80]; 


wndclass.style 
wndclass.lpfnWndProc 
wndclass.cbClsExtra 
wndclass.cbWndExtra 
wndclass.hlnstance 
wndclass.hlcon 

wndclass.hCursor 
wndclass.hbrBackground 
wndclass. IpszMenuName 
wndclass.IpszClassName 


CS_HREDRAW I CSJREDRAW; 
(WNDPROCIWndProc; 


: hlnstance; 

: LoadlconCNULL, 
IDLAPPLICATION); 

■ LoadCursor(NULL,1DC_ARR0W); 

■ GetStockObject(WHITE_BRUSH); 

■ NULL; 

=1 pszCl ass; 


RegisterClasst&wndclass); 
hWnd=CreateWindowt1pszClass, 

IpszClass, 

WS_OVERLAPPEDWINDOW I WSJISIBLE. 

0 , 0 , 200 , 200 , 

NULL, 

NULL. 

hlnstance, 

NULL); 


ShowWindowt hWnd,nCmdShow); 
UpdateWindowthWnd); 

while(GetMessage(&msg,NULL,0,0)) { 
TranslateMessage(Amsg); 
DispatchMessaget&msg); 

) 

returntmsg.wParam); 


LONG FAR PASCAL WndProctHWND hWnd, WORD message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hDC; 

PAINTSTRUCT ps; 

RECT rect; 

switch(message) { 
case WM_PAINT: 

hOC=BeginPaint(hWnd,&ps); 

GetClientRectt hWnd,&rect); 

DrawText(hDC,"Hel1o, Windows!",-1,Arect, 


Using WinSpector to Trap 
Parameter Validation Errors 


Robert Mashlan 
P.O. Box 1587 
Boulder, CO 80306 
Internet: rmashlan@mash.bouIder.co.us 

One of the new features added to Windows 3.1 is pa¬ 
rameter validation on API functions. It's a good idea to 
clean up parameter validation faults, since parameter vali¬ 
dation errors usually are proportional to the mysterious 
bugs that appear in Windows applications. 

The Dr. Watson utility that comes with Windows logs 
parameter validation errors, but these errors will not be 
noticed until the log is inspected. (Note: To log parameter 
validation errors, add a showinfo=par entry to the [Dr. Watson] 
section of win. ini). Moreover, when errors do occur, Dr. 



Listing 1 continued 


DT_SINGLELINEIDT_CENTERIDT_VCENTER); 
EndPaint(hWnd.Aps); 
return(0); 

case WM_DESTROY: 

PostQuitMessage(0); 

return(0); 

} 

returnCDefWindowProcChWnd,message,wParam, IParam)); 

} 

/* End of File */ 


Listing 2 

whello.def 

NAME 

WHELLO 

DESCRIPTION 

’Hello program with auto-detection of multiple! 
instances’ 

EXETYPE 

WINDOWS 

STUB 

’WINSTUB.EXE’ 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

8192 

EXPORTS 

WndProc 


Listing 3 whello.mak 


// Visual C++ 

(Microsoft 

C 8.0) NMAKE file 

whello.exe : 

whello 

obj 

whello.def 

link /al 

ign:16 

/ nod 

whel1o,whel1o.exe,NUL,siibcew 1ibw.whel1o 

rc whell 

o.exe 



whello.obj : 

whello 

c 


cl /c /Zp /ASw 

/Gsw 

/Ow /W2 whello.c 
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Watson's stack dump is quite cryptic if you are developing 
with non-Microsoft languages. 

The WinSpector utility that comes with Borland C++ 
3.1, along with the DFA analyzer, can produce stack 
dumps with source module names and line numbers if the 
application being developed has the appropriate debug¬ 
ging information. However, WinSpector does not trigger 
on parameter validation faults from the Windows kernel. 

You can force parameter validation errors to be imme¬ 
diately noticed in your application by generating a general 
protection fault such that the function which passed the 
invalid parameter will show up in the WinSpector stack 
trace. To do this, have your application install a notifica¬ 
tion function with the NotifyRegisterO routine in tool- 
help.dll. The notification procedure can generate a gen¬ 
eral protection fault upon detection of an invalid parameter. 
This will make finding these little nasties much easier, but you'll 
want to remove this 'feature' before delivering the application. 

One of the limitations of the DFA, the tool that creates 
detailed stack dumps from WinSpector's log files, is that it 
runs into sharing violations when it tries to read some of 
the Windows system files while Windows is running. To 
make life a little easier, create a batch file called WINSTART.BAT 
with the following lines in the Windows directory: 

c: 

cd \windows 

if exist winspctr.log dfa winspctr.log 


Listing 4 trap.c 


/* trap.c 

compile with: "bcc -U -2 -P -v trap.c” 

*/ 

^include <window$.h> 

^include <toolhelp.h> 

#pragma argsused 

BOOL CALLBACK _export NotifyProct WORD wld, DWORD dwData ) 

// note: no need for an instance thunk or smart callbacks, since 
// this routine does not access the program's DGROUP. 

{ 

if( wld == NFYJ.OGPARAMERROR ) // invalid parameter notification 

*(LPSTR)NotifyProc = 13; // Trying to write to a code segment 
// generates a general protection 
// fault. 

return FALSE; 

} 

void BadFunction(void) 

( 

LocalFreetNULL); // this causes a parameter validation error 

} 

^pragma argsused 

int PASCAL WinMaini HINSTANCE hlnst, HINSTANCE hPrevInst, 

LPSTR lpszParams, int nShow ) 

( 

NotifyRegister(GetCurrentTask(),NotifyProc.NF_NORMAL); 
if( IDYES ** MessageBoxtNULL,"Cause a parameter validation error?". 
"Trap”,MB_YESNO) ) 

BadFunctionO; 

NotifyUnRegister(GetCurrentTaskO); 
return 0; 

) 

/* End of File */ 
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Figure 1 Sample DFA.OUT output file 


4 KERNEL <no info 

CS:IP 0001:056B C0117:056B) S$:BP Z907:19F4 
C:\WIND0WS\SYSTEM\KRNL386.EXE 


5 TRAP BadFunctlonO +000A 

CS:IP 0001:019F (290F:019F) SS:BP 2907:19FC 

D:\ARTS\TIPS\FWIN\MASH\TRAP.EXE 

TRAP.C line: 22 


6 TRAP WINMAIN +002F 

CS:IP 0001:0ID0 (290F:01D0) SS:BP 2907:1A00 

D:\ARTS\TIPS\FWIN\HASH\TRAP.EXE 

TRAP.C line: 32 


7 TRAP <no into 

CS:IP 0001:0063 (290F:00B3) SS:BP 2907:1A0E 
D:\ARTS\TIPS\FWIN\NASH\TRAP.EXE 


MINSTART.BAT will be executed automatically whenever Win- Listing 4 shows an example Windows application that 
dows starts or restarts. Simply restarting Windows after a will generate a parameter validation fault when executed, 
fault will regenerate the DFA. OUT file. Before running this program, start WinSpector such that it 

will trap the general protection fault. Compile the program 
with full debugging information (the full compiler com¬ 
mand line is shown in the comments; no module defini¬ 
tion file is required since the defaults are adequate), and 
run it. After getting the fault, use DFA on the UINSPCTR.LOG 
file in the windows directory. In the stack dump file, 
DFA.OUT, BadFunctlonO will appear in the stack trace with 
the line number of the bad call to LocalFreeO. 

Figure 7 shows a sample DFA.OUT file created on my system 
using the technique outlined above. Entry #5 shows the bad call 
to LocalFreeO made from within BadFunctlonO (line 22 of 
trap.c). 

The first version of this Tip submitted by Mr. Mashlan kept 
crashing my Windows systems; hunting down the problem led 
to a discovery that the documentation relating to some of the 
key Windows functions involved is not very clear. Mr. Mashlan 
explains: 

I think I found the problem. What has happened is that 
the SDK documentation for NotifyRegisterO is misleading. 
It says that if you use NULL as the first parameter, Noti¬ 
fyRegisterO will send notifications for the current task. It 
appears that this is incorrect; instead, it sends notifications 
for all tasks. What happened is that another task gener¬ 
ated a parameter validation, so the GP fault was gener¬ 
ated more than once. The system probably hung because 
it got into a loop doing this. The stack dump was from the 
last GP fault, which was not directly from the sample pro¬ 
gram. 

So, the solution is to change the first parameters of 
both NotifyRegisterO and NotifyUnregisterO from NULL to 
GetCurrentTaskO. 

Listing 4 shows the corrected version. -Iz □ 


WANTED: INCREDIBLE 

SOFTWARE ENGINEER 

Highly skilled in one or more areas: 

* Object oriented programming in C++ 

* Experience with MS Windows environment 

* CAD systems development 

* Graphics experience with 3D & rendering 

FOR: INCREDIBLE 

COMPANY ON THE MOVE 

* Developers of 3D Architectural Design 
software for professionals & consumers 

* Extensive media reporting by CNN, Windows 
Magazine, U.S. News & World Report, etc. 

IN: MAGNIFICENT 

Coeur d' Alene, Idaho 

* Boasting pristine lakes, towering forests 

* Close-in boating, snow skiing 

* Top-ranked golf course & 5 star hotel 

FAX resume & salary requirements to 408-778-2167 

ART, Inc. 800-482-4433 


0 TRAP not1fyprtx:(uns1gned short,unsigned long) +0008 

CS:IP 0001:0178 (290F:0178) SS:BP 2907:1970 
D:\ARTS\TIPS\FWIN\MASH\TRAP.EXE 
TRAP.C line: 9 


1 TOOLHELP <no into 

CS:IP 0001:1E12 (2ADF:1E12) SS:BP 2907:1998 
E:\BC\BIN\TOOLHELP.DLL 


2 KERNEL <no into 

CS:IP 0001:9A96 (0117:9A96) SS:BP 2907:19DA 
C:\WINDOWS\SYSTEM\KRNL386.EXE 


3 KERNEL <no Into 

CS:IP 0001:94AD (0117:94AD) SS:BP 2907:19EC 
C:\WIND0WS\SYSTEM\KRNL386.EXE 
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Window Subclassing 


Ron Burk 


This is the sixth in a series of columns about the design and implementation 
of WUIMAN (the Windows User Interface MANager). Previous columns have 
described the basic design of WUIMAN as a hierarchical tree of objects, each of 
which corresponds to a user interface element such as a window or menu. I 
have created basic classes to support saving the hierarchical tree to disk and 
manage generic lists of pointers. This column provides code to hook window 
messages, a necessary tool for making WUIMAN work with existing programs. 

Window Subclassing 

One of my goals for WUIMAN is to be able to take one of my existing 
applications and incrementally make it take advantage of WUIMAN for its user 
interface. In order to do this, WUIMAN will need to tinker with user interface 
objects (mostly windows) that it did not create. 

The need to tinker with windows you did not create actually arises fairly 
often in Windows, and it is one of the main ways that user interface code gets 
reused in Windows programming projects. The classic example is an edit con¬ 
trol. No one wants to write an edit control from scratch, since the built-in Win¬ 
dows edit control represents thousands of lines of C code. Instead, when you 
want something just a bit different, you can tinker with the messages that flow 
to a standard edit control and get the slightly altered behavior you need. 

A common strategy for tinkering with an existing window is called subclass¬ 
ing. Subclassing a window is analogous to taking over a DOS interrupt vector. 
First, you fetch the address of the current message handler for the window: 

WNDPROC OldHandler = GetWindowLong( 

Window, GWL_WNDPROC); 

Then, after you store the address of the old message handler in a safe place, 
you poke the address of your new message handler into the window: 

SetWindowLong(Window, GWL_PR0C, MyHandler); 


Ron Burk 



Borland C++ v3.1 
Symantec C++ v6.0 
Visual C++ vl .0 


The code for your new message handler will typi¬ 
cally examine the messages that come in, tinker 
with a handful of them, but pass most messages 
straight on to the old message handler. 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 12 years. He is working on a book tentatively titled WinHelp for Programmers 
and Technical Writers. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (". . . luunetirdpubironb”). 











Listing 1 w_atom.h — Declaration for GlobalAtom 
class 


// w_atom.h - class to handle global atoms 

#ifndef W_AT0M_H 
#define W_AT0M_H 

#1f !(defined(_INC_WINDOWS) II definedC_WIND0WS_H)) 

yAinclude <windows.h> 

#endif 

#if Idefined(WUISTDJ) 

#include "wuistd.h" 

#endif 

class TGlobalAtom 
{ 

public: 

TGlobalAtomtconst char *AtomName): 

TGIobalAtomlconst TGIobalAtom& Atom): 

~TGlobalAtom(); 

TGIobalAtoms operator=(const TGIobalAtom& Atom); 
operator ATOMO const; 

HANDLE GetPropertytHWND Window) const; 

int SetProperty(HWND Window, HANDLE Value); 

// unsigned short is often more convenient 
int SetProperty(HWND Window, unsigned short Value); 

HANDLE RemovePropertytHWND Window) const; 
private: 

ATOM GlobalAtom; 

}; 

inline 

int TGlobalAtom::SetProperty(HWND Window, 

unsigned short Value) 

{ MEMBERASSERTO; 

return SetPropertytWindow, (HANDLE)Value); 

) 

inline 

TGlobalAtom:operator ATOMO const 
{ MEMBERASSERTO; 
return GlobalAtom; 

} 

#endif // W_AT0M_H 
/* End of File */ 


Listing 2 w_atom.c — Definition of GlobalAtom 
management class 


#include "w_atom.h" 

const int MAX_ATOM„NAME = 160; 

// constructor 

TGlobalAtom::TGIobalAtom!const char *AtomName) 

: G1obalAtom(G1obalAddAtom!AtomNaroe)) 

{ MEMBERASSERTO; 

ASSERT(G1obalAtom != NULL); 

} 

// destructor 

TGlobalAtom::~TG1obalAtom!) 

{ MEMBERASSERTO; 

ASSERT!Global Atom ! = NULL): 

G1obalDeleteAtom(GlobalAtom); 

} 

// copy constructor 

TGlobalAtom::TGlobalAtom(const TGlobalAtomS Atom) 
: GlobalAtom(NULL) 

{ MEMBERASSERTO; 

// let assignment operator do all the work 
*this = Atom; 


Listing 2 continued 


} 

// Assignment operator 

TGlobalAtomJ TGlobalAtom::operator=(const TGlobalAtomA Atom) 
{ MEMBERASSERTO; 

// conspiracy with copy constructor 
1f(GlobalAtom != NULL) 

Global DeleteAtom(GlobalAtom); 
char AtomName[MAX_ATOM_NAME+l]; 

ASSERT2C 

GlobalGetAtomNametAtom.G1obalAtom, AtomName, 
MAX_ATOM_NAME) < MAX_ATOM_NAME 

); 

GlobalAtom = GlobalAddAtom(AtomName); 

ASSERTCG1obalAtom != NULL); 
return *this; 

} 

HANDLE TGlobalAtom::GetPropertytHWND Window) const 
{ MEMBERASSERTO; 

return GetProp(Window, (LPCSTR)MAKELP(0, GlobalAtom)); 

} 

int TGlobalAtom::SetProperty(HWND Window, HANDLE Value) 

{ MEMBERASSERTO; 

return SetProptWindow, (LPCSTR)MAKELP(O, GlobalAtom), 


HANDLE TGlobalAtom::RemoveProperty(HWND Window) const 
{ MEMBERASSERTO; 

return RemoveProptWindow, (LPCSTR)MAKELP(0, GlobalAtom)); 

} 

/* End of File */ 


Listing 3 w_hook.h — Declaration for window 
subclassing class 


// w_hook.h - declarations for hooking window messages. 

#ifndef W_H00K_H 
#define W_H00K_H 

#if !(defined(_INC_WINDOWS) II defined!_WIND0WS_H)) 

#include <windows.h> 

#endif 

class TWindowSubclass 

{ 

public: 

TWindowSubclasstHWND Window); 

// redefine: always 

virtual LRESULT Handler(HWND Window, UINT Message, 

WPARAM Paraml, LPARAM Param2); 

protected: 

// hokey special constructor for default subclass 
TWi ndowSubcl ass 0; 
virtual -TWindowSubclassO; 
private: 

// I don't support assignment, 

// so declare but don't define these two: 

TWwindowSubclasstconst TWindowSubclass&); 

TWindowSubclass& operator=(const TWindowSubclass&); 

static LRESULT CALLBACK _export WindowHook!HWND,UINT, 

WPARAM.LPARAM): 

static WNDPROC UnhooktHWND Window. 

TWindowSubclass ‘First); 

TWindowSubclass ‘Next; 

}; 

#endif // W_HOOK_H 
/* End of File */ 
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Safe Subclassing and Unsubclassing 

Microsoft's Knowledge Base contains an article 
(Q101180) entitled 'Safe Subclassing' that describes win¬ 
dow subclassing and offers advice on how to perform 
window subclassing safely. The article reproduces the 
standard Microsoft advice; "Microsoft suggests that you 
not subclass the control classes.' The reason is that Mi¬ 
crosoft may change the standard control classes in the 
next version of Windows in a way that breaks your sub¬ 
class message handler. Since Microsoft's documentation 
for the standard control classes is far from rigorous or 
complete, it is fairly easy to end up depending on some 
behavior that is technically undocumented, in fact, it is 
quite difficult to say exactly what as¬ 
pects of Windows are documented or _ 

not, since Microsoft issues additional 
technical information in a variety of 
forums (online CompuServe support, 
the Microsoft Developer's Network 
CD-ROM, Microsoft Systems Journal, 
etc.) informally and with ambiguous 
authority (when Microsoft's pseu¬ 
donymous 'Dr. Gui' reveals the un¬ 
documented fact that you can pass 
an instance handle to GetModuleHan- 
dle(), does that make it documented 
behavior?). 

In practice, the fact that the next 
version of Windows may break your 
code can often be a risk worth tak¬ 
ing. It would be absurd to duplicate 
all the code in the standard edit con¬ 
trol when all you need is an edit con¬ 
trol that accepts only numbers, for 
example. As is often the case in Win¬ 
dows programming, you will have to 
use your experience and judgment to 
decide which risks are worth taking 
for the project at hand. 

One general problem with sub¬ 
classing (and with intercepting DOS 
interrupts) is getting yourself out of 
the chain safely and cleanly. The 
problem arises because someone 
else may subclass the same window 
after you do. Consider the following 
chain of events to see where the 
danger lies. 

Suppose you subclass a window 
by saving the window's current mes¬ 
sage handler and replacing it (via 
SetUindouLongO) with your own. The 
natural place to store the previous 
message handler is with window 
properties (using SetPropO), but you 
must make sure you remove the win¬ 
dow properties before the window is 
destroyed, or you will have a resource 


Listing 4 w_hook.c — Definition of window 


// wjiook.c - implement window subclassing code 

#include "wuistd.h" 

#include "w_atom.h" 

♦include "wjiook.h” 

// Atom names and handles for fast window properties, 
static TGlobalAtom FunctionLow("WUIMAN_FunctionLow"); 
static TGlobalAtom FunctionHigh("WUIMAN_FunctionHigh"); 

// TWindowSubclassDefault - an object of this class gets put 
// at the end of the chain, and calls the window’s 
// previous window procedure. 
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leak that can cause Windows to run out of memory. To 
solve that problem, suppose your message handler 
watches for a UM_NCDESTROY (presumably the last message a 
window ever receives) and takes that opportunity to put 


the old message handler back (via SetUindowLongO) and 
free up the window properties by calling RemvePropO. 

So far so good, but what if some other code subclassed 
the window after you did? In that case, the other code 
saved the address of your window handler away and 


Listing 4 continued 


class TWindowSubclassDefault : public TWindowSubclass 

{ 

public: 

TWindowSubclassDefault(HWND Window, WNDPROC Old): 
virtual LRESUIT HandleriHWND Window. UINT Message, 

WPARAM Paraml. LPARAM Param2) 

{ MEMBERASSERTO; 

return 01dHandler(Window. Message, Paraml, Param2); 

} 

private: 

// WindowHook wants to use OldHandler. 

friend LRESULT CALLBACK _export WindowHookiHWND,UINT, 

WPARAM.LPARAM); 

WNDPROC OldHandler; 

}; 

// constructor - take over window, start chain of handlers. 
TWindowSubclassDefault::TWindowSubclassDefault(HWND Window, 

WNDPROC Old) 

: 01dHandler(01d) 

{ MEMBERASSERTO: 

// make window point to me as first handler 
FunctionLow.SetPropertytWindow, (HANDLE)L0W0RD(this)); 
FunctionHigh.SetPropertytWindow,(HANDLE) HIWORD(this)); 

} 


// GetClassPointerO - Fetch my object from window handle, 
inline 

static TWindowSubclass *GetClassPointer(HWND Window) 

{ 

HANDLE Low = FunctionLow.GetProperty(Window): 

HANDLE High = FunctionHigh.GetProperty(Window): 

return (TWindowSubclass *)MAKELP(High, Low); 

} 

inline 

WNDPROC CurrentHandler(HWND Window) 

{ 

return (WNDPROC)GetWindowLong(Window, GWLJNDPROC); 

} 

// UnhookO - delete all but last handler. 

WNDPROC TWindowSubclass::Unhook(HWND Window, 

TWindowSubclass *Subclass) 

{ 

// first, delete all the "real" subclass objects 
while(Subclass->Next != NULL) 

{ 

TWindowSubclass *Temp = Subclass; 

Subclass = $ubclass->Next; 
delete Temp; 

} 
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stored its own address in the window. This means that 
when your code restores the previous message handler, it 
will be writing over the address of the more recent sub¬ 
class procedure. The code that subclassed the window af¬ 
ter you will never get called again, and if that code 
needed to free up any resources (such as window proper¬ 
ties), you may have a resource leak on your hands. If you 
think it unlikely that foreign code will subclass your win¬ 
dows, consider ctl3d.dll, the Microsoft DLL that provides 
three-dimensional dialog and message boxes; one of its 
niftiest features is that, with a single function call, it will 
automatically subclass all the dialog and message boxes 
that your application uses to provide the 3-D effects. 

As far as I can see, there is no perfectly safe way to 
perform window subclassing so that it could not poten¬ 


tially break someone else's subclassing code. Still, there 
are some precautions you can take. When I subclass a 
window, I store the old window handler in a data struc¬ 
ture pointed to by window properties. My window handler 
attempts to take itself out of the chain at four points: be¬ 
fore and after processing both UM_DESTROY and UM_NCDESTROY 
messages. I figure that most people who write window 
subclassing code will try to take themselves out of the 
chain at one of those four points. At all four points, my 
function checks to see if it is the current message handler 
for the window. If not, it does not try to replace itself with 
the previous message handler. In any case, it will free up 
the window properties after the UM_NCDESTROY message (if it 
has not done so previously), since there will be no other 
opportunity to do so. 


Listing 4 continued 


// we happen to know last in chain is an 

} 

// object of type TWindowSubclassDefault 

else 

TWindowSubclassDefault *Default = 

{ // else it is ok to unhook right now 

(TWindowSubclassDefault *)Subclass; 

WNDPROC OldHandler = UnhookCWindow. Subclass); 

// second, remove our window properties 

return 01dHandler(Window. Message, Paraml, Param2); 

ASSERT21 

} 

FunctionLow.RemoveProperty(Window) != NULL 

} 

ASSERT2 ( 

TWindowSubclass:TWindowSubclass(HWND Window) 

FunctionHigh.RemovePropertytWindow) != NULL 

: Next(NULL) 

): 

{ MEMBERASSERTO; 

WNDPROC Current = CurrentHandler(Window); 

ASSERTCWindow 1= (HWND)NULL); 

// put back previous window procedure (assume it's safe) 

// might already be a linked list of handlers 

SetWindowLongtWindow, GWL WNDPROC, (LONG)Current); 

TWindowSubclass ‘CurrentHandler = 

delete Default; 

GetClassPointer(Window); 

return Current; 

if(CurrentHandl er == NULL) 

} 

{ // then we have not poked window proc yet 

// WindowHookO - Entry point for all subclassed windows. 

WNDPROC OldHandler = (WNDPROC)SetWindowLong(Window, 

GWL WNDPROC, (LONG)WindowHook) ; 

LRESULT CALLBACK export TWindowSubclass::WindowHook( 

ASSERT2( 

HWND Window, UINT Message, WPARAM Paraml, LPARAM Param2) 

new TWindowSubclassDefault(Window, OldHandler) 

{ 

!= NULL 

TWindowSubclass ‘Subclass = GetClassPointer(Window); 

); 

ASSERT(Subclass != NULL); 

CurrentHandler = GetClassPointer(Window); 

} 

ASSERT(CurrentHandl er != NULL); 

// if it’s not the end of the line 

if(Message != WM DESTROY && Message 1= WM NCDESTROY) 

// point me to previous first handler 

// then just call first subclass function in chain 

this->Next = CurrentHandler; 

return Subclass->Handler(Window, Message, Paraml, Param2); 

} 

// else, try to unsubclass the window 


LRESULT Result = 0; 

// constructor called only by TWindowSubclassDefault 

TWindowSubclass;TWindowSubclasst ) 

// if it's not safe on the way down 

: Next(NULL) 

if(CurrentHandler(Window) != WindowHook) 

{ MEMBERASSERTO; 

{ // then pass the message on 

} 

Result = Subclass->Handler(Window, Message, Paraml. 


Param2); 

TWindowSubclass::~TWindowSubclass() 

// and see if it’s safe on the way back 

{ MEMBERASSERTO; 

if(CurrentHandler(Window) == WindowHook) 

} 

{ // then unhook and we are out of loop 


Unhook(Window. Subclass); 

// Handler!) - by default, just pass to next handler in chain 

return Result; 

LRESULT TWindowSubclass::Handler(HWND Window, UINT Message, 

} 

WPARAM Paraml, LPARAM Param2) 

else if(Message == WMJCOESTROY) 

{ MEMBERASSERTO: 

{ // if last chance! 

ASSERTtNext 1= NULL); 

Unhook(Window, Subclass); 

return Next->Handler(Window. Message, Paraml, Param2); 

return Result; 

} 

else // else try again on WM NCDESTROY 

} 


return Result; 

/* End of File */ 
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TGIobalAtom 

Window properties are 16-bit integers (32-bits under 
Windows NT) associated with a window via a string con¬ 
stant. You attach a window property to a window like 
this: 

int Value = 5; // or whatever 
SetProp(Window, "Stuff", (HANDLE)Value); 
and you can retrieve it later like this: 

Value = GetProp(Window, "Stuff"); 

You might think such an associative store would be 
fairly slow, but it is quite fast if you use Windows 'atoms' 
(roughly, a reference-counted string facility) instead of 
string constants. As it does with many other resources, 
Windows forces you to allocate and free global atoms ex¬ 
plicitly; failure to do so correctly can lead to loss of inter¬ 
nal Windows memory and an eventual crash. It thus be¬ 
comes attractive to put the resource management in a 
C++ class to reduce the danger of resource loss. 

w_atom.h (Listing 1) contains the declaration of TGlobalA- 
tom, a class that encapsulates Windows global atoms. TGlo- 
balAtom is a concrete class - i.e., assignment works cor¬ 
rectly and you can use it pretty much as you would a 
built-in data type such as int. w_atom.c (Listing 2) contains 
the implementation of TGIobalAtom. This is a straightfor¬ 
ward encapsulation of a the Windows global atom API. 

TWindowSubdass 

w_hook.h (Listing 3) contains the declaration for TUindow- 
Subclass, a class for intercepting window messages. I tend 
to use the word 'hook' and 'subclass' interchangeably in 
the context of Windows programming. Windows does 
provide a set of 'hook' functions that let you intercept 
window messages under specific conditions; those func¬ 
tions actually provide a safe protocol for unhooking as 
well, but direct window subclassing will be more efficient 
for my purposes. w_hook.c (Listing 4) contains the definition 
for TUindowSubclass. 

To create a subclass function that modifies a certain 
kind of window, you would begin by deriving a class from 
TUindowSubclass, and overriding the virtual function TUin- 
dowSubclass::Handler(), which will get called for every win¬ 
dow message the subclassed window receives. Your han¬ 
dler can do whatever it likes with the message, but it will 
typically pass most messages on to the next handler. The 
messages will continue on down the chain of handlers un¬ 
til they reach the original window procedure, which usu¬ 
ally does most of the work. To pass a message on to the 
next handler in the chain, just call the parent class han¬ 
dler, TUindowSubclass::Handler(), since it is defined to just 
pass the message on down the chain. 

As with many classes, object creation and deletion was 
an interesting part of designing TUindowSubclass. I decided 
to tie object creation to subclassing the window - you 
must supply a window handle to create an object of type 
TUindowSubclass. For simplicity, and since you typically will 
subclass a window for its entire lifetime, I tied object deletion 
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to the demise of the window with which the TUindowSub¬ 
class object is associated. Your new message handler 
should not count on receiving a UM_DESTROY message, but 
should instead handle any cleanup it needs to do in its 
destructor. You should not ever delete a TUindowSubclass 
object yourself, although I did not completely protect 
against that. 

Internally, TUindowSubclass manages a linked list of TUin¬ 
dowSubclass objects associated with a window. When you 
create a new object of type TUindowSubclass, it first checks 
to see if the window has already been subclassed. If so, it 
just adds itself to the beginning of the chain. The first ob¬ 
ject to attach itself to a window creates the window prop¬ 


erties that contain a 32-bit pointer. Unfortunately, window 
properties are only 16-bit entities in Windows 3.1, so I 
have to use two window properties to store a pointer to 
the first TUindowSubclass object. 

A TUindowSubclass object is simple: it only contains a 
pointer to the next TUindowSubclass object in the chain. 
However, somewhere I must store the address of the pre¬ 
vious window message handler, so that when my one or 
more subclass functions finish processing a message, they 
can pass it on to its original destination. I handled this by 
creating a local helper class (TUindowSubclassDefault) that 
has room to store the original window procedure (of type 
UNDPROC ). The first time a window gets subclassed, I always 
stick one of these objects last in the 
chain, so that when a window mes¬ 
sage gets passed to it, it can forward 
it to the original UNDPROC. 

All of this initialization takes place 
in the constructor for TUindowSubclass, 
and things got a bit messy. I ended 
up giving TUindowSubclass a special, 
parameterless constructor just to 
serve TUindowSubclassDefault. The rea¬ 
son is that I wanted the TUindowSub¬ 
class object to construct the end-of- 
chain TUindowSubclassDefault, which 
would implicitly call the TUindowSub¬ 
class constructor (its base class con¬ 
structor) again. The extra constructor 
lets me do what I intended without 
running into an infinite loop. 

A single function (TUindowSub¬ 
class:-.UindowHookO) provides the en¬ 
try point for all subclassed windows. 
Most of the time, all it has to do is 
fetch the pointer to the first TUindow¬ 
Subclass object and pass the message 
on to its HandlerO function. If the 
message is UMJESTROY or UMJCDESTROY, 
however, then UindowHookO will at¬ 
tempt to safely restore the previous 
window procedure. 

Summary 

This month's code disk has the 
complete WUIMAN source, including 
code from past issues. The code disk 
is widely available via sources listed 
in the table of contents. Next month, 

I plan to implement a simple user in¬ 
terface for interacting with the WUI¬ 
MAN database. □ 
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Instant-C 

Jeffrey L Armbruster 


Programming takes too long. How many iterations 
does it take to write the code, compile, link, test, debug, 
then write the code... until you have a completed pro¬ 
gram? What if you could compile, link, test, and debug all 
at the same time? In Figure 1, I've loaded Rational Sys¬ 
tem's Instant-C, and typed the following (my keystrokes 
are in italics): 

line 1: int a = 1; 

line 2: int *iptr; 

line 3: iptr = &a; 

line 4: *iptr 

line 5: 1 

line 6: iptr 

line 7: address 1AB0. 

line 8: char *string = "This is a test"; 

line 9: string 

line 10: address 1AB8: "This is a test" 

Instant-C instantly compiles the code and prints the results 
on the next line. 

Instant-C, by Rational Systems, is an extraordinary pro¬ 
grammer's tool. It compiles every line of code as you write 
it, so you can use it to interactively debug and edit exist¬ 
ing code and to explore the syntax of the language. It lets 
you experiment with a function or a line of code to opti¬ 
mize it or improve it, or just to watch how your program 
works - interactively. Instant-C is a debugger, compiler, 
interpreter, editor, and code browser wrapped into a sin¬ 
gle environment that is easy to use and explore. 

You start by loading an existing program or coding a 
new program from scratch in Instant-C's editor. When you 
load a large file, Instant-C compiles it at about one-half to 
one-quarter of the speed of your compiler. You can save 
an image of the compiled program so that Instant-C 


doesn't need to recompile it every time you reload a ses¬ 
sion. Or you can simply save the source code of the pro¬ 
gram you are working on. You can step through several 
lines of your code and save your current position; when 
you reload Instant-C it will remember where you were and 
the state of your program, allowing you to continue de¬ 
bugging or rewriting from where you left off. 


Product Information 


Instant-C v5.4 

Rational Systems, Inc. 
220 North Main Street 
Natick, Massachusetts 01760 
(508) 653-6006 
FAX (508) 655-2753 
CompuServe: 73667,1753 
BIX: rational 


Price: $2,995. Includes unconditional, 90-day, money- 
back guarantee. You can get free upgrades by purchas¬ 
ing an additional $450/year maintenance contract. 

Summary: An integrated, interactive environment for 
writing, debugging, and understanding DOS C pro¬ 
grams. Incremental compilation means you can make 
changes on the fly (even during debugging) to the 
source code, without waiting for a lengthy recompila¬ 
tion and relink. 


Jeffrey Armbruster works for PIA Merchandising Company in Irvine, California, as a Senior Programmer/Analyst, programming in 
C/C++, Assembly, and Clipper for DOS and MS Windows. He can be reached on CompuServe at 72711,3565. 
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# int a = 1; 

# int *iptr; 

# iptr = &a; 
ft »iptr 

1 

# iptr 

address lflfl8 

# char *string = "This is a test"; 

# string 

address lflflE: "This is a test" 

# ^string 

address lflflC 
tt *string 

’T' (0x54) 

# *string+2 

86 (0x56) 

# *(string+2) 

'i' (0x69) 
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Accessing External Libraries 

Instant-C can access code in external librar¬ 
ies, but you have to supply it with some inter¬ 
face information. Suppose this function: 

void WriteLn(char *string) 

{ puts( string ) ; } 


is object code stored in utils.lib. Before you 
can use the function, you need to prepare an 
Instant-C interface file with the following text: 

{{pragma loadlib "Utils" 
void WriteLn( char *string ) 

{extern;} 

You will need to do this for every function in 
the library. You also have to account for any 
globally declared data. For example, if the 
UriteLnO function prints a global variable called 
string rather than taking a string argument, the 
interface file might look like this: 

extern char ‘string; 

{{pragma loadlib "Utils" 
void WriteData(void) 

{extern;} 

If you already have a file of prototypes, this is 
largely a global replace operation. □ 


Instant-C resembles a debugger in 
that you can set it to trace a function 
or to inspect or change a variable. 
You can even examine the function 
calls on the stack and branch back to 
the call that called the current func¬ 
tion. Debugging with Instant-C is not 
always as fast as with an ordinary 
debugger, since some debuggers take 
advantage of the 80386's hardware 
debug registers to monitor memory 
access (watchpoints) at hardware 
speeds. However, you can make 
source code changes while debug¬ 
ging with Instant-C, something no or¬ 
dinary debugger can accomplish. You 
will still want to have a compiler and 
linker, because Instant-C is not in¬ 
tended as a replacement for either. 
Yet, it is a full-blown software devel¬ 
opment environment that allows you 
to code, compile, debug, test, and 
edit in a single program. Rational 
claims that Instant-C can handle a 
project that contains 400,000 lines of code consisting of 
1,000 separate files, and 65,000 unique names. 

With an existing program, instant-C loads the file, com¬ 
piles it, and checks it for syntax errors. If an error is de¬ 
tected, Instant-C displays the code and a diagnostic mes¬ 
sage in the editor, where you can fix the problem right 
away. When you later run the code, Instant-C also checks 
for runtime errors. When it finds one, it splits the screen 
into three horizontal sections, as shown in Figure 2. The 
top section is Instant-C's Debug window, where the of¬ 
fending line of code is highlighted with an error message. 
The second section contains the values of any local variables 
and any watch variables you may have set. The third section 
is the command section, very similar to Codeview's arrange¬ 
ment, except that with CodeView you can't edit the error 
and get an instant recompile of the changes. Hit Alt-F5 to 
switch to the editor, fix the error, then hit F9 and Instant-C 
compiles the code. If it is error-free, your program continues 
executing, updating any watch variables you may have set, 
until it hits a breakpoint or another error. 

if you want to create a wrapper function to intercept a 
call to a particular function or perform a parameter check, 
you can quickly create one in instant-C. In C, you would 
need to rewrite your program to call the wrapper function. 
With Instant-C you simply write the command: 

{/wrap my_fimc check_my_func 

and Instant-C will reroute all calls from my_func() to 
check_my_func(). When you're satisfied that my_func() has 
been debugged, just type: 

#unwrap nty_func 

and all calls will be directed back to my_func(). 
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Figure 2 Instant-C detects an error 
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If you have several modules and 
want to see all references to a par¬ 
ticular module or where a module is 
defined, you can access the Browser 
and CrossReferencer from the main 
menu (see Figure 3) to jump to the 
file where the function is defined, or 
display all of the files that refer to it. 

You can configure Instant-C to dis¬ 
play its output on two monitors: 
monochrome for Instant-C, and VGA 
color for your program output. You 
can also tell Instant-C to use your fa¬ 
vorite editor - although this slows 
things down considerably. 

Instant-C needs 4Mb of memory 
and 4Mb of disk space. It is compat¬ 
ible with Microsoft C (6.0 - 8.0) and 
Borland C (3.1) compilers. The default 
installation uses the medium memory 
model and Instant-C's C library. If you 
want to use a different memory 
model or Borland- or Microsoft-spe¬ 
cific library functions, you will need 
to rebuild Instant-C to handle the memory model and li¬ 
brary of your choice. 

If you have a list of repetitive commands, Instant-C can use 
command scripts to help you save time. Set the commands into 
a file, load it, and Instant-C will read and execute the commands. 


Documentation 

Instant-C comes with three manuals. The Runtime Li¬ 
brary manual lists and describes the C language functions 
implemented in the Instant-C library. The Reference Manual 
contains detailed information about Instant-C's menus, 


O CD-ROM Software 

Walnut Creek CDROM 

• C Users' Group Library R01 $49.95 

Volumes 100 to 364. Source code for editors, disassemblers, compilers, interpreters, communications, games, tutorials, math libraries. Most 
code for MSDOS, much for UNIX and other systems. Disk includes the first three text editions of the CUG Directory: indexing and describing 
every file and reviewing major packages. 

• Libris Britannica R02 $69.95 

Public domain and shareware from PDSL, Sussex, for DOS: extensive sections on electronics, engineering, mathematics, medicine, ham 
radio, including the entire C Users' Group UK archive. 
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• Source Code R03 $39.95 

The Usenet archives, Simtel20 Unix-C archives, and a large collection of MSDOS source code. Simtel20 Unix-C are mostly complete working 
programs for archiving, benchmarks, databases, editors, file management, graphics, compilers and interpreters, printer utilities, communications, 
networking. MSDOS source is almost 2000 Zipped packages including Autocad utilities, editors, archivers and compression programs, 
emulators, compilers and interpreters; mostly C source code. 


• CICA Microsoft Windows R04 $24.95 

The entire CICA Windows Collection from Indiana University, hundreds of utilities, including shells, disk utilities, mouse and keyboard utilities, 
screen savers, backup/restore programs, performance monitors, diagnostics, data conversion programs, and games. 


• SIMTEL20 MSDOS R05 $24.95 

The entire Simtel20 MSDOS archive, 640 megabytes in 9000+ files. Many include source code, usually in C. Programming tools for APL, assembly, 
C, Pascal, Perl, Prolog, Smalltalk, etc. Communications utilities, BBS's, compression programs, shells, editors, graphics, menus, and games. 

• Garbo MSDOS/Mac R06 $24.95 

Contains the MSDOS and Mac archives from the University of Vaasa, Finland, almost all in English from Europe and America. MSDOS files are 
250 megabytes including programs for animation, archive utilities, BBS's programming tools, system utilities, business, science, education. 


To Order Call 913-841-1631 FAX 913-841-2624 

□ Request 242 on Reader Service Card □ 
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ttdef ine 0_RD0NLV 0 


ttdef ine OJIRONLY 
ttdef ine 0_RDWR 


ttdef ine 0_CREflT 
ttdef ine 0_TRUNC 


0x0100 

0x0200 


ttdef ine 0_RAW 0x8000 
ttdef ine 0_BINARY 0x8000 
ttdef ine 0_APPEND 0x0008 


options, editor, expanded error messages, and DOS/16M 
function library. The User's Guide introduces you to Instant- 
C, and walks you through its features. However, the inter¬ 
face is so easy to use that you'll want to start playing with 
the program and get some of the basics before opening 


the manuals. Instant-C's menus or 
menu-equivalent command-line 
prompts drive the program. Hit FI for 
a help list of commands (see Figure 
4) or menu navigation help. If you 
make an error, Instant-C prompts you 
with one of its 700 error messages to 
quickly teach you what it expects. 
Once you correct the error, Instant- 
C's incremental compiler compiles it 
and shows you the results on the 
next line. No need to compile, link, 
run, test, over and over, ad nauseam, 
until your program works correctly. 

Limitations 

Instant-C does not currently work 
with C++. Rational Systems plans to 
release a C++ version of Instant-C in 
1994. Instant-C does not work with 
Windows code, or dynamic link li¬ 
braries. A release for Windows is also 
planned for the future. If you want to 
use a commercial library that isn't 
supplied with Instant-C, you have to prepare the commer¬ 
cial library so that Instant-C can accept it. This involves 
building Instant-C interface files (see the sidebar). If you 
have a large library with a hundred or more functions, it 
may take a few hours to prepare the interface file. Building 


Pearl Software presents WinEmacs 


Emacs for Windows 


WinEmacs U a fully functional Windows 3.1. version of the 
industry standard program editor Gnu Emacs, version 19*3* 
WinEmacs is available with all Gnu Emacs source code. WinEmacs 
is fully compatible with the Lucid Inc. Unix version of Gnu Emacs. 

WinEmacs retains all the Emacs features you are used to: 


• Clipboard support 

• Scroll bars 

• DDE and OLE support 

• Binds any arbitrary combination of a 
key and key modifiers to Emacs Lisp 
code 

Memory Requirements: 8MB RAM, 15MB disk space 
How you can obtain WinEmacs 

You can try the demo version of WinEmacs without cost by contacting Pearl 
Software at pearl@netcom.com (e-mail) (510) 273-9795 (voice) or (510) 839-9820 
(fax). If you decide to use it, please register for technical support from Pearl ($199). 
This will entitle you to all upgrades (NT version soon!) for one year, and access to our 
BBS which posts bug fixes and full Emacs source code.. 

WE ALSO PROVIDE EMACS CONSULTING SERVICES 

Pearl Software, 320 Lenox Ave., Oakland, CA 94610 


• Syntax expansion and indenting 

• Begin/end structure and brace 
matching 

• Word wrap and full justification 

• Runs programs from within editor 

• Configurable key bindings to arbitrary 
Emacs Lisp functions 

• Compatibility with UNIX emacs 
configuration tables 

• Mode line 

• Huge library of Emacs Lisp for other 
extensions 


• Emacs Lisp Extension Language 

• Hypertext help, on-line manual 

• Line, block, character marks 

• Full undo and redo 

• Multiple buffers 

• Edits arbitrarily large files 

• Regular expression search/replace 

• Incremental search 

• Procedure tagging with completion for C, 
C++, Pascal, Lisp, and many others 


Plus WinEmacs has these extended fe 

• Separate buffers in different windows 

• Menu and drop-down menu bar 

• Multiple font-size and type support 

• Cut and paste mouse support 

• Support for text and Binary files 

• Support for foreign keyboards 


I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

Windows/DOS 

□ DEVELOPER'S JOURNAL 

Call 913 - 841-1631 today for 
information about 
advertising opportunities in 

Windows/DOS Developer’s Journal. 
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Technical. 


1 Brian 

Osborn - Continental Europe. 

1+49 431-396895 
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Figure 4 tnstant-C’s online help 
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the file involves inserting information 
for the object code, including declara¬ 
tions for all data and functions referred 
to in the library's object code but not 
defined there. If you don't have access 
to the source code, this could be a ma¬ 
jor problem. You also have to include 
information about the object code, such 
as function return types, parameter 
names, and data types. Rational esti¬ 
mates that creating an interface file takes 
about an hour, plus about a minute for 
each function in the library, if you have 
a prototype file. 

Conclusion 

This is a superior debugging and 
C learning tool. If you can write it in 
C, you can write it and make it better 
with Instant-C, whether you're doing 
memory moves, disk file loads, or 
writing interrupts. However, at 
$2,995, Instant-C is out of reach for 
most students and many program¬ 
mers. Although this version is only 
for DOS, in some ways Instant-C is what many program¬ 
mers expected when Microsoft announced Visual C++: an 
interactive, integrated, incremental compiler, debugger, 


and editor. For that reason, upcoming versions of Instant-C 
for C++ and Windows may be products for Windows pro¬ 
grammers to watch for. □ 



S.I.P.-Uninstall for Windows 

+ analyses all changes of an installation. 

+ watches over AUTOEXEC.BAT, CONFIG.SYS and any other text files. 
+ watches over SYSTEM.INI, WIN.INI and any other INI-files. 

+ watches over every harddrive with all changes (new, deleted, 
changed with size, date/time, attributes and CRC checksum). 

+ enables saving of any file before the installation. 

+ offers a detailed protocol of all changes and files belonging to the 
installation. 

+ uninstalls 100% of all changes! 

(Deleted or changed files must have been saved with S.I.P.-Uninstall before the installation!) 

Fax or write for FREE demo! 


A network version is available! 


s. 


D 


Tel.:+49-951-43489 
FAX:+49-951 -420514 
- SOFTWARE SOLUTIONS 
Griesaeckerstr. 15 

D-96117 Memmelsdorf nzsriHHH 
GERMANY 

CompuServe 100120,2601 


S.I.P.-Uninstall f.W. $99 

Network version $155 


Please note disk format! 

International: add $10 for shipping and handling to all 
prices. 

□ Request 252 on Reader Service Card □ 



Accessing dBASE files has never been easier! 

Features: 

^ Royalty free DLLs for OS/2 and Windows 

^ File and record locking APIs 

Handle based calls 

^ Memo field & index support 

^ Static libraries for DOS, Windows, and OS/2 

dbfLIB gives C programmers the easy task of accessing dllASF. files while 
maintaining the speed and size of C programs. The APIs in dbfLIB are 
fully compatible across DOS, Windows, and OS/2. 



Visa and MasterCard 
accepted. (713)537-0318 


dSOFT Development Inc. 
4710 Innsbruk Drive 
Houston, TX 77066 
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Windows/POS 

□ DEVELOPER'S JOURNAL 

New Products 

Industry-Related News & Announcements 


Automator QA Automates Windows Testing 


Direct Technology Limited has released the Windows 
version of AUTOMATOR QA, its automated software test¬ 
ing tool. AUTOMATOR QA Windows Edition provides fea¬ 
tures for testing GUIs, including: automatic checking of 
Windows objects such as dialogs or menus; reporting 
and analysis of test results; intelligent screen recognition, 
with the ability to recognize text regardless of font, color, 
or position; bitmap checking in either position-inde¬ 
pendent or absolute modes; and an intelligent identify fa¬ 
cility enabling the definition of proprietary screen 


regions. The Windows version also offers features in¬ 
cluded with the DOS version, such as automatic test 
script generation, test management and maintenance, a 
script language, test logging and reporting, and error re¬ 
covery. 

Automator QA Windows Edition Development Soft¬ 
ware costs $1,250; and volume discounts are available. 
For more information, contact Direct Technology Limited, 
10 East 21st Street, 11th Floor, New York, NY 10010, 
(212)475-2747 or (800) 486-7565; FAX (212) 529-4941. 


Quadbase Ships SQL Servers for NetWare and NT 


Quadbase Systems, Inc., has released Quadbase-SQL 
XB Server, a client/server version of their Quadbase-SQL. 
Quadbase-SQL XB Server is a relational database engine 
that compiles with ANSI SQL 89 level 2 plus extensions, 
and is available for Novell NetWare (running as a Net¬ 
ware Loadable Module) and Windows NT. 

Features of the database include declarative referen¬ 
tial integrity with full integrity options, scroll cursors, 
multi-table outer join that conforms to SQL2 and ODBC 
standards, concurrency control through four isolation lev¬ 
els, BLOB data type for multimedia applications, crash re¬ 
covery, query optimization, and transaction processing. 


The product supports Xbase data and index file formats. 
Client applications can run under Windows or DOS. 

Other tools in the package include Windows and DOS ad 
hoc query and report writing tools, Visual Basic custom 
controls, an embedded SQL preprocessor, an ODBC 
driver, and report writer. 

The Quadbase-SQL development kit with a single- 
user SQL engine running under Windows costs $795. 

The SQL servers cost from $995 to $5995, depending on 
the number of users. For more information, contact 

Quadbase Systems, Inc, 790 Lucerne Drive, Suite 51, Sun¬ 
nyvale, CA 94086, (408) 738-6989; FAX (408) 738-6980. 


EMS Updates Shareware Libraries 

EMS Professional Shareware has updated two of its li¬ 
braries (available on floppies or CD-ROM) for program¬ 
mers and consultants. The WINUTIL Library contains 739 
utilities, covering topics such as backup, benchmarking, 

. bmp file manipulation, communications, database, disas¬ 
sembly, memory management, file compression, graph¬ 
ics, and program management. The C/C++ Utility Library 
has more than 1,000 products for programmers using 
C++, Microsoft C, and Turbo C, with products falling into 
categories such as arrays, binary trees, bit manipulation, 
communication, compression, debugging interrupts, 
linked lists, memory management, security, sorting and 


so on. Both products come with an indexed database to 
help you locate products by vendor, name, type, release 
date, or free text search across descriptions. 

The WINUTIL Library costs $59.50 on CD or $99.50 
on diskette; the C/C++ Utility Library costs $59.50 on CD- 
ROM or $149 on diskette, and a subset of the library con¬ 
taining 406 files (on 20 disks) just for C++ costs $59.50. 
For more information, contact EMS Professional Share¬ 
ware, 4505 Buckhurst CL, Olney, MD 20832-1830, (301) 
924-3594; FAX (301) 963-2708; Internet eengel- 
mann@worldbank.org. 
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Spread/VBX Update Offers Q+E/LB Support 


Spread/VBX v2.1 is a new version of a Visual Basic 
custom control that provides a variety of spreadsheet fea¬ 
tures. You can use the control to implement spread¬ 
sheets, grids, listboxes, toolbars, and other controls. The 
control includes over 250 properties, and it automatically 
configures column types, colors, borders, and widths. 

This version features increased speed and direct support 


for Q+E/LB, giving you read/write and virtual functional¬ 
ity. 

Spread/VBX v2.l costs S245. For more information, 
contact FarPoint Technologies, Inc, 585A Southlake 
Boulevard, Southport Office Park, Richmond, VA 23236, 
(800) 645-5913 or (804) 378-0432; FAX (804) 378-1015. 


StratosWare Creates Portable Version of Memory Checker 


StratosWare Corporation has created an ANSI-compli¬ 
ant source code version of MemCheck, its automatic er¬ 
ror detection tool for C programmers. MemCheck was 
formerly available only on DOS, Windows, and the 
Macintosh, but can now be used in any ANSI or K&R- 
compliant environment. MemCheck for ANSI and K&R de¬ 
tects memoiy overwrites and underwrites, memory 
leaks, heap corruption, out-of-memory conditions, and 
other memory errors. The package works at runtime to 
identify errors by source file and line number. You can di¬ 
rect error messages to the screen, write them to log files, 
or send them in network or email messages. 

Developers can ship applications with MemCheck 
linked in, royalty-free, and detect errors at beta or cus¬ 


tomer sites. Applications with MemCheck linked in run 
unchanged and at full speed, but you can activiate Mem¬ 
Check with a single environment variable. The approxi¬ 
mate code size overhead is 15Kb. 

MemCheck for ANSI and K&R costs $199, includes 
free technical support (via Fax, CompuServe, Internet, or 
a toll-free number), and comes with a 30-day, money- 
back guarantee. MemCheck for DOS (supports Microsoft, 
Borland, WATCOM, and MetaWare compilers) costs $139 
and MemCheck for Windows or Macintosh costs $99. 

Site license discounts are available. For more informa¬ 
tion, contact StratosWare Corporation, 1756 Plymouth 
Road, Suite 1500, Ann Arbor, Ml 48105,(313) 996-2944 
or (800) 933-3284; FAX (313) 747-8519. 


DynaZIP DLLs Give Windows Applications .zip Access 


inner Media, Inc. is shipping DynaZIP Data Compres¬ 
sion Library for Microsoft Windows, a library that lets de¬ 
velopers give their programs the ability to read, test, 
create, modify, and write standard .zip files without hav¬ 
ing to spawn a DOS session. The royalty-free DynaZIP 
DLLs can read and write files compatible with the latest 


version (2.04g) of PKZIP from PKWare, Inc. The DynaZIP 
DLLs are compatible with any language that can call DLL 
functions, such as C, C++, Visual Basic, Pascal, and so on. 

DynaZIP costs $249 per developer station. For more 
information, contact Inner Media, Inc, 60 Plain Road, Hol¬ 
lis, NH 03049, FAX (603) 465-3216; (603) 465-7195. 


New WinWord Add-in Supports Help Authoring 


FlelpBreeze is a new Word for Windows add-in that 
lets programmers and writers create online Windows 
help systems. HeipBreeze includes point-and-dick sup¬ 
port for all features of the Windows 3.1 help engine (Win- 
Help), including secondary windows, help macros, 
custom buttons, hypergraphics, and add-on DLLs. Auto¬ 
mated, two-way conversion between help files and 
printed documentation allows developers to use the 
same material for both online help and printed manuals. 
The package includes a royalty-free DLL that lets devel¬ 
opers easily add slide shows, sound, and bitmap anima¬ 
tions to help files. 


HeipBreeze automates some of the tedious aspects of 
developing help files. You can define and renumber 
browse sequences, using drag-and-drop to order the top¬ 
ics, and you can insert bitmap graphics for bullet points 
merely by clicking the normal Word for Windows bullet 
tool. Point-and-dick support is included for defining all 
help project options, and you can compile and test the 
help file from within Word for Windows. 

HeipBreeze costs $279. For more information, contact 
Solutionsoft, 999 Evelyn Terrace West Suite 86, Sunny¬ 
vale, CA 94086, (408) 736-1431; FAX (408) 736-4013; 
CompuSen'e 75210,2214. 


RoboHELP Update Handles WinWord v6.0 


Blue Sky has updated RoboHELP to be compatible 
with the latest version of Word for Windows (WinWord). 
RoboHELP is a WinWord add-on that provides a com¬ 
plete help authoring system. RoboHELP v2.6 is now com¬ 
patible with WinWord v6.0. 

RoboHELP can automatically convert existing text 
into a help system or a help system into user documenta¬ 
tion. It can import existing WinWord files and convert 
headings to topics and index entries into search key¬ 
words. RoboHELP also imports any existing help project 


source code. The product provides access to all the fea¬ 
tures of the Windows help engine, including macros, sec¬ 
ondary windows, and multiple hotspot graphics. 

RoboHELP v2.6 costs $499; upgrades from the cur¬ 
rent version cost $29, and upgrades from RoboHELP vl .0 
cost $229. For more information, contact Blue Sky Soft¬ 
ware Corporation, 7486 La Jolla Blvd., Suite 3, La Jolla, CA 
92037, (800) 677-4946 or (619) 459-6365; FAX (619) 
459-6366. 
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HLPDK Update Supports Multimedia 

ISoft D&M has updated HLPDK, their help develop¬ 
ment tool that specializes in multi-platform help develop¬ 
ment. HLPDK is a shareware hypertext and hypermedia 
help database development kit that includes two royalty- 
free help engines and a help compiler with a built-in 
cross reference tool. HKPDK lets you create help files for 
various environments from a single help source. Sup¬ 
ported environments include Windows 3.x .hip files, 
OS/2 . ipf files, THELP, DESQview/X, QuickHelp, TVHC 
vl.1, and POPHELP. 


The new version includes Microsoft Multimedia 
Viewer support, native graphic support for WinHelp, 
Viewer, and OS/2; native sound support in WinHelp and 
Viewer, and native application launch links for WinHelp, 
Viewer, and OS/2. 

HLPDK vl 0.0 registration costs $50, plus shipping 
and handling. Help Engine TurboPascal sources are avail¬ 
able for an additional $100. For more information, con¬ 
tact ISoft D&M, P.O. Box 5517, Coralville, IA 52241, (319) 
351-8413; CompuServe 76350,333. 


Aeris Offers DOS/Windows Data Manipulation 


Aeris is an automated file and record processing pack¬ 
age available for Windows and DOS. Aeris is built to han¬ 
dle custom file processing applications (searching, 
multi-key sorting, conversion, merging, replacement, etc.) 
and offers high-level script commands and functions that 
can access all or parts of files In a single action. After writ¬ 
ing custom scripts, you can encapsulate them in icons, 
build them into Aeris custom menus for end users, or set 
them up for batch processing. You can also provide us¬ 


ers with multiple custom menu bars for different directo¬ 
ries. 

Aeris costs $129.95; an introductory offer lets you li¬ 
cense either Aeris for Windows or Aeris for DOS for $69 
each. For more information, contact BlueRithm Software, 
21823 North Glen Drive, Colbert WA 99005-9415, (509) 
468-1434; FAX (509) 467-2699; CompuServe 
72704,2273. 


Victor Image Processing Libraries Gain JPEG Support 


Catenary Systems has updated both the DOS and 
Windows versions for their Victor Image Processing Li¬ 
brary, which provides bitmapped image manipulation 
functions for DOS and Windows programs. Vidor con¬ 
tains image processing fundions such as brightness and 
contrast adjustment, sharpen and outline filters, matrix 
convolution for designing your own filters, resize, rotate, 
and image combinations. 

The new Vidor Library for Windows includes the 
fundions loadjpgO and savejpgO, which read and write 
grayscale and color images using JPEG compression. 
JPEG compression can drastically reduce an image's 
space requirements while retaining image quality. 
savejpgO lets you specify a quality parameter from 1 to 
100 that determines the resulting image integrity and 
compression efficiency. For example, a quality of 50 cre¬ 


ates a highly compressed file (15:1) with little visible im¬ 
age degradation. 

The Vidor Library for DOS has been completely re¬ 
vised to include all the fundions in Vidor for Windows. It 
now includes the ability to load and save BMP and JPEG 
image files, in addition to TIFF, PCX, GIF, and TGA file for¬ 
mats. New fundions allow conversion between bilevel, 
grayscale, palette color, and RGB color images. You can 
use color redudion to convert 24-bit RGB to 8-bit color 
images of 2 to 256 colors. Vidor Library for DOS sup¬ 
ports EGA, VGA, Super VGA, and VESA display adapters 
in 2 to 16 million colors at resolutions up to 1280x1024. 

The Vidor Library for Windows costs $295, and the 
Vidor Library for DOS costs $195. For more information, 
contad Catenary Systems, 470 Belleview, St Louis, MO 
63119,(314)962-7833. 


Inlite Creates Bar Code Recognition Engine 


Clearlmage/Barcode is a bar code recognition engine 
for scanned and faxed images that can handle images 
with real-life problems such as skewed bar codes, touch¬ 
ing bars, black noise between bars, and white noise 
within bars. Clearlmage/Barcode recognizes horizontal, 
vertical, or skewed bar codes, automatically locates bar 
codes anywhere on the image or in predefined areas, rec¬ 
ognizes unlimited numbers of bar codes per image, auto¬ 
matically deteds bar code type, and converts bar code to 


ASCII text, reporting bar code location and orientation. 
The library supports the following bar code types: 
Codabar, Interleaved 2/5, Code 128, Code 39, Code 93, 
and UPC/EAN/ISDN. 

The Clearlmage/Barcode toolkit costs $895; a single¬ 
station runtime license is $395. For more information, 
contad Inlite Research, Inc, 355 West Olive Ave, #211, 
Sunnyvale, CA 94086, (408) 737-7092; FAX (408) 737- 
7093. 
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Crescent Adds, Updates Visual Basic Tools 

Crescent Software, Inc., has released NetPak Profes¬ 
sional for Visual Basic, a Windows and DOS library for 
programmers who want to add network capabilities to 
their Visual Basic applications. NetPak Professional Net¬ 
Ware functions include print functions, bindery functions, 

QMS functions, connection functions, workstation func¬ 
tions, file server environment functions, message func¬ 
tions, directory functions, and TTS functions. Other 
function groups support Microsoft Windows for Work¬ 
groups and miscellaneous Windows API functions. 

XREF for Visual Basic is another new product from 
Crescent Software. XREF for Visual Basic lets Windows 
programmers cross-reference applications written using 
Visual Basic. It lists all forms, controls, properties, events, 
methods, variables, arrays, constants, and procedures al¬ 
phabetically, by type and scope, even across separate 
modules. XREF features include: source listings with head¬ 
ers and line numbers; understanding all DOS Basic 
source listing metacommands; extracting quoted strings 
and remarks for spelling checking; identifying unused 
symbols and procedures; creating CALL tree diagrams; 
generating symbol summary reports; and identifying the 
same variable across modules. 

Crescent has updated QuickPak Professional, their col¬ 
lection of custom controls for Visual Basic. The new ver¬ 
sion of QuickPak Professional includes two new controls: 
CSHyperText and CSCaption. CSHyperText is a rich text la¬ 
bel control that lets developers mix font attributes and 


colors via simple codes inserted in the text. CSHyperText 
controls can display jump or popup text as it is displayed 
in WinHelp, via custom events. CSHyperText also sup¬ 
ports scrolling when text exceeds the display area. 
CSCaption is similar to the Visual Basic frame control in 
that it provides a caption and an area in which you can 
place a child control. CSCaption goes further, though and 
lets developers add three-dimensional effects to the child 
control, even if that control does not directly support it. 

Crescent has also updated PDQComm for Windows, 
a communications toolkit for Visual Basic v3.0. Based on 
the MSComm control included with Microsoft's Profes¬ 
sional Toolkit for Visual Basic, this custom control lets 
programmers transfer binary files in the background us¬ 
ing ZModem, XModem, YModem, CompuServe, or Ker- 
mit protocols. Developers can optionally display a status 
dialog box with a percentage complete meter. Terminal 
emulations offered include ANSI, DEC VT52 and VT100, 
and TTY terminals. 

NetPak Professional for Visual Basic with Win- 
dows/DOS costs $$179. XREF for Visual Basic costs $99. 
QuickPak Professional v3.10 costs $199 (upgrades from 
the current version are $59). PDQComm v2.0 costs $149 
(upgrades cost $59). Crescent Software provides com¬ 
plete, commented source code for all their products. For 
more information, contact Crescent Software, Inc, 11 
Bailey Avenue, Ridgefield, CT06877, (203) 438-5300; 
FAX (203) 437 -4626; CompuServe: 70662,2605. 


Vermont Enters Windows Testing Market 

Vermont HighTest is a new software testing tool for 
Windows programmers. Vermont HighTest automatically 
records test scripts as the user runs a program, recording 
keystrokes, mouse events, screen images, and the inter¬ 
nal details of window controls. You can then join and or¬ 
ganize these test scripts into test suites with the 
package's interactive Suite Manager, creating script hier¬ 
archies and setting up loops for multiple script execut¬ 
ion, with no programming required. 

Other features include a playback log file that reports 
the complete results of every command and command 
subset. An integrated debugger allows full control of all 


playback and offers single-step and breakpoint capabili¬ 
ties, and the option to terminate on the first failure. 
Mouse events are reproducible even if the same window 
appears in a different size and new location each time it 
is displayed. Masking features let you ignore areas of the 
screen during bitmapped screen comparisons. 

Vermont HighTest costs $495 and includes free sup¬ 
port and a 60-day money-back guarantee. For more in¬ 
formation, contact Vermont Creative Software, 1 Pinnacle 
Meadows, Richford, VT 05476, (802) 848-7731; FAX 
(802) 848-3502. 


NewWorld Development Kit Offers Video for Windows Alternative 


Digital Video Arts, Ltd., has released the NewWorld 
Development Kit for Windows 3.0, a development kit for 
DVI multimedia developers. This kit lets you place high- 
quality, full-motion video in your Windows application, 
either in a window or full screen. The kit supports DVI ac¬ 
celerated animation, compressed high-resolution images, 
graphics, image processing, video effects, and custom mi¬ 
crocode. The kit also supplies a migration path for New- 
World-DOS developers. 


The NewWorld Development Kit for Windows 3.0 
costs $2395 and includes one year of technical support. 
For more information, contact Digital Video Arts, Ltd., 
Twining Center, Suite 107,715 Twining Road, Dresher, 
PA 19025, (215) 576-7920; FAX (215) 576-7932. 


February 1994 


Windows/DOS Developer's Journal — Page 81 






Readers' Forum 


Ron, 

Have you seen the conversation in BCPPWIN over the 
BC++ 4.0 license agreement? Apparently there are two 
clauses that have people upset. I'd like to know what you 
think of this. 

Sb: BC++ 4.0 
Fm: Lou Grinzo [71055,12401 

My Borland C++ v4.0 arrived shortly after this note from 
Lou, so I read through the license, which I might normally ig¬ 
nore. Sure enough, tucked inside Borland's famous "No-Non¬ 
sense" license was something entitled "Borland Additional Li¬ 
cense Terms for Development Products," and it ironically con¬ 
tains more nonsense than any competing vendor's compiler li¬ 
cense statement. It's quite large, but I will quote from the two 
key points that have really stirred up Borland customers. The 
first has to do with building competing products: 

Your programs may not be generally competitive with or a sub¬ 
stitute for any Borland development product or the Borland product 
you use to create your programs; may not be an operating system; 
and (if this is a Borland database product) may not be a general- 
purpose interactive information management and/or database de¬ 
velopment environment or program. 

In general, license statements tend to have a vague state¬ 
ment designed to prevent totally unscrupulous behavior, such as 
renaming the files in the product and distributing it at half the 
price as "Brand X C++". However, this Borland clause goes far 
beyond that. The words "generally" and "any" could cover a lot 
of ground. Also, you might think that only a few companies 
make operating systems, but in fact, many embedded systems 
developers end up making their own tiny operating systems - 
they are not going to care for this clause. Almost as important 
as the technical meaning is the philosophical implication, I 
think. Borland has traditionally been the company with pa¬ 
nache, winning its battles by simply having the best products. 
To see it put an anti-competitive clause like this in its compiler 
license is a bit like seeing Santa Claus being arrested for a DI/I//. 
Unfortunately, the second clause is even worse: 

Given the litigious nature of certain of its competitors, however, 
Borland is forced to impose some limitations on the redistribution 
of the patented technologies provided in this package. Thus, if you 
are the licensed, registered user of this product, you may, under 
Borland's patent rights, distribute, sell, or give away to third parties 
up to ten thousand copies of such application programs per year 
free of any patent royalties, subject to all the conditions in this 
statement. This royalty-free license is non-transferable and noncu- 
mulative, meaning that neither you nor your company can increase 
the ten-thousand-copy limit by acquiring additional packages of this 
software. Moreover, this limitation applies regardless of the num¬ 
ber, type, or version of application program produced. Should you 
desire a royalty-free license to distribute more than ten thousand 


copies per year under Borland's patent rights, please call our OEM 

licensing department. 

Note that the wording implies that Borland will not 
charge you money to distribute more than 10,000 copies, 
just that you must get their permission. However, who 
wants to get written permission from Borland everytime 
they want to upload a little demo program to Com¬ 
puServe (which could imply more than 10,000 copies will 
get distributed)? I'm sure this license was designed to deal 
with Borland's legal tribulations with a few other large 
software companies, and that Borland had no intention of 
using the restrictions against the average developer, but 
who wants to grant Borland (or any other company) such 
a large amount of legal discretion over their own software 
development? 

There has been a large amount of discussion on Com¬ 
puServe about the unacceptability of these terms, but I will not 
go over the points raised in detail here because, as we go to 
press, Borland has stated that they are drafting a new license 
agreement Until the new license agreement appears, there's not 
much to talk about. Clearly, they goofed, they realize it, and 
they are getting ready to take a second stab at the problem. 

One niggling problem remains even assuming the new li¬ 
cense agreement removes all the problematic restrictions. The 
current license says "This statement may be modified only in 
writing signed by you and an authorized officer of Borland." 
That means that a mere announcement by Borland that they 
are voiding the previous license does not affect your legal obli¬ 
gations if you already bought and started using Borland C++ 
v4.0. One option Borland is looking into is offering a free up¬ 
grade that comes with a new license; presumably the new li¬ 
cense would cover the upgraded product and hence supersede 
the old one. Borland has also offered to provide a permission 
letter to waive some of the current license's restrictions. If you 
want one of these, contact Borland at 

ATTN: Ms. Karen Rogers 
Corporate Affairs 
Borland International 
100 Borland Way 
Scotts Valley, CA 95066 
(408) 431-4880 (voice) 

(408) 431-4171 (FAX) 

At the moment, I have not discovered the exact wording of 
this waiver. If it only covers a specific product that you are mak¬ 
ing, I suspect that will probably not be acceptable to the major¬ 
ity of customers. I am writing this on January 6, so I assume 
that by the time you read this, Borland will have resolved the 
issue. Just make sure that if you buy Borland C++ v4.0 you read 
the license agreement so you know what you're buying into. 
Borland C++ v4.0 has some significant new technical features 
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for C++ programmers, so it will be a shame if this license con¬ 
troversy overshadows the product itself. I have a growing nos¬ 
talgia for the good old days when the only legal concern I wor¬ 
ried about when writing software was to make sure I spelled my 
name right in the copyright notice, -rib 


Dear Editor: 

My book Windows Network Programming, which was re¬ 
viewed in the November 1993 issue of Windows/DOS De¬ 
veloper's Journal, does indeed have a source code disk. 
The disk is not included in the book, and there is no men¬ 
tion there of how to obtain it, but I am distributing it for 
$25 from my own office. Your readers can reach me 


either via CompuServe ID 71161,1060, or at my office 
phone, 703-720-6909. 

Thank you very much for the attention you gave to 
Windows Network Programming. I am currently writing the 
NT version of the book; perhaps there is fruit for future 
articles. After writing networked software for NT, I don't 
want to be reminded that there is still a Windows 3.1! 

Ralph Davis 
Davis Software Productions 
3206 Titanic Drive 
Stafford, VA 22554-2627 

Thanks for taking the time to let us know - and good luck 
with the NT version, -mm 
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Windows source, 
WinToAsm con deliver It! 

WtnToAsm 

Disassembles MS-Windows EXEs, 
DRVs, DLLs, and VxDS, by 
segment, range, or export. 

Labels exported and imported 
functions, VxD services, 
control proc, API entry, etc. 

Generates segment, export, 
import, and header tables. 

Supports batch-mode tagging of 
functions and data items 

ResToKC 

Decompiles resources to a RC file. 

Vextract 

Extracts VxDs from Win386. 

All for only $94.95! 
30-day Money-Back Guarantee 

Eclectic Software 

937 Jungfrau Court 
Milpitas.CA 95035 
(408) 262-3264 Voice/FAX 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 


The Time 
Has Came... 

...to send for the latest copy of 
the free Consumer Information 
Catalog. It lists more than 800 
free or low-cost government 
publications. Send your name 
and address to: 

Consumer Information Center 
Department TH 
Pueblo, Colorado 81009 

U.S. General Services Administration 


C++ SOURCE CODE 


T pi tV. The World s Leading 

I m cp Nfsrvrt ruM'sne' »' c ++ 

1111 UwC U>vi l Development loots 
1 Presents 

ISCL™ containing more than 
140 volumes of high 
quality C++ source code 
(both shareware and 
freeware) including: 

• Neural Nets • Compilers 
Communications • GUIs 
Tutorials • Matrix/Numerical 
• Memory Management • Databases/ 
ISAM • Utilities (e.g. Demangler, Beautifier. etc.) 

• Graphics • And Much, Much More 

All For Only $ 99 " (on CD Rom) 

Also available on 3.5” and 5 1/4” 

Contact: ImageSoft Incorporated 

2 Haven Avenue • Port Washington, New York 11050 
Tel: (516) 767-2233, Fax: (516) 767-9067 
EMAIL: mcdhup!image!iscl 



Export Your 
Software Now 


Let us help you increase your export sales! 
Octagon develops foreign markets for 
small and medium size software publish¬ 
ers, including start-ups. 

• Quickly penetrate new markets 

• Conserve scarce internal resources 

• Find the best distributors and 
republishers for your product 

• All fees based on your success 


<8 
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Octagon Trade 
Group, Inc. 

Suite 102, 3020 Pickett Rd„ #759 
Durham, NC 27705 
Tel: 919-493-1651 Fax:919-493-1915 
^^aj^^E^ICK@DE^H^OM 
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Dear Editor: 

I've been a subscriber for a few years. I have a small 
shareware business and make frequent use of information 
I gather from your magazine. I would like to take this op¬ 
portunity to express my appreciation for the WDDJ.HLP 
index I discovered in the CompuServe R&D forum. I'm not 
sure who should receive the credit so I am forwarding 
these comments to you in hopes that the appropriate indi¬ 
viduals) will be thanked for me. I did not notice it before 
nor did I see any reference to it in past issues. I am very 
pleased with this approach and method of archiving issue 
indexes and references. 

Along the same lines, has R&D considered providing 
back issues and program listings on CDROM? I extensively 


use Microsoft's "Developers' Network" CDROM. I believe 
most software developers now have CDROM drives or are 
considering purchasing one in light of the fact that Win¬ 
dows documentation and reference has become so large 
and cumbersome that hard copy is just about useless. 
Then add to that: the ability to cut and paste source from 
the CDROM right into your program; the ability to elimi¬ 
nate most of the sample files that are distributed with 
each new compiler release (and SDK) from your hard 
drive; and that extra bookshelf space you now have since 
moving all those SDK manuals to the attic. 

Thanks again. 


Tom Coates 
President 
AppsWare 
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We Understand The 
Programmer's Mind 


When the country's top firms look for the 
best developers available, they turn to 
Bateman. Why? Because we specialize in 
Microsoft Windows, NT. OS/2 and Macin¬ 
tosh recruiting nationwide. So if it's time for 
a career move, give us a call. We under¬ 
stand your skills, and the marketplace for 
them... we understand you. 

□Bateman Inc. 

5847A Uplander Way 
Culver City. CA 90230 
Tel; 310-641-4100 Fax:310-641-2900 
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Multiple COM: Ports With Windows! 

* WINDOWS 3.x AND NT COMPATIBLE 

* 1,2,4 OR & PORT RS-232 BOARDS 

* WINDOWS UTILITY SOFTWARE 
PROVIDED 

* XT AND AT INTERRUPT JUMPERS 

* DRIVER AVAILABLE FOR 9 COM: PORTS 
WITH WINDOWS 3.1 

* MADE IN USA 

* EXCELLENT TECHNICAL SUPPORT 


SEALEVEL SYSTEMS. INC. 
PO BOX 63 O 
LIBERTY, SC 29657 

803 - 643-4343 


SEALEVEL 
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USING C++ OBJECTS WITH 
SQL RDBMS’s??? 

The Solution Isn’t Obvious, It's 

SUBTLE WARE™ FOR C++/SQL 


* Uses your C++ Class 
Definitions 

* Fully supports the C++ 
Object Model 

* Automatically generates 
SQL mapping code 

* Provides Portable Object 
Persistence across a variety 
of SQL RDBMS’s 


* Works with your existing 
RDBMS’s and tools 

* Shortens your development 
and maintenance time 

* Fits into most C++ 
environments, including 
Borland C++ and Visual 
C++ 


/^ANSI SQL Engine: $300 

CALL 1-508-663-5584 

30 Day Money Back Guarantee 
Ask about availability of other 
v Database Specific Modules 



Subtle Software 
Inc. 


1 Albion Road 
Billenca, MA 01821 
FAX: 508-663-5685 


Subdeware™ is a tredamarV of Subtle Software. Inc Other product names are 
trademarks of their respective holders 
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Diskette I/O 

Cede Libraries 
Device Drivers 

VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

WV7a| pv PO Box 5700 
k_7 y vJ-V^yV Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 


Tools for Novell's Btrieve® 

Bsupport III lisupportll 

lied it 3.0 - Btrieve file viewer/editor. 
Banalyze 2.0 • Btrieve app. debugger. 

Brun 2.2 - BUTIL replacement plus source. 
Bcreate 2.0 - file creation utility. 

Bcheck 2.0 - Btrieve file analyzer. 

Xsupport 1.0 • build data dictionary 
(.DDF) for Access, OV, 
Crystal Rpts. 

Xport 2.0 - export/import CDF, SDF, 
dBASE. 

Call for information on additional 
products and FREE demo! 

Information Architects, Inc. p| l: (goo) 359-2721 
3130 Pine Tree Road (517)887-8000 

Lansing, MI 48911 Fax:(517)887-2366 
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Windows 

Developer Jobs 

Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 

Mac, CASE, Video, Realtime. 

Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1-800-231-5920 
Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SP1-8, Box 71, San Ramon, CA 94583 (510)733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 854-9444 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
Vcompuserve: 71250,3001; Genie: D.SMALL6 J 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only $129 + $5 s&h ($15 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 
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IPX Toolkit 


This custom control allows a Visual 

Basic developer to write distributed, 
client/server applications. The control 
abstracts the networking layer of a 
workstation and 
allows applications 
to communicate on 
top of various 

transports including 
IPX and NetBIOS. 

A separate Windows dynamic-link library 
(DLL) is available for each transport and 
is demand-loaded based on a 

workstation's networking configuration. 
$295 Per Transport. 

Intelec Systems 

10201 W. Markham, Ste. 101 
Little Rock, Arkansas 72205 
Tel (501) 221-3600 • Fax (501) 221-7412 
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Career Marketing Associates 

7100 East Belleview Avenue, Suite 102 
Englewood, CO 80111 

Today, 1993 

Dear WINDOWS DEVELOPER: 

Do you know where the best 
Windows development jobs are? I spend 
my time looking for strong 
opportunities for Windows developers 
and software engineers. I might be 
looking for someone with your 
qualifications right now. And there you 
sit in the corner reading a magazine! 
Pay attention, this is your future we 
are talking about. Currently I have 
multiple jobs requiring Windows 
experience, C++, or GUI. If you are 
thinking about a career change, 
shouldn’t you be working with a 
specialist? All fees are paid by the 
company. Write, call, fax, or 
communicate by smoke signals, I’my 
waiting to hear from you. J 


Sincerely, 



Gary Patton 
303-779-8890 
FAX 303-779-8139 


Opt-Tech Sort/Merge 


New-Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 ) 
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CDROMs for Work and Play! 


Giga Games CDROM $39.95* 

Over 2700 Games for Microsoft Windows and 
MSDOS. 250 Megs of games plus 150 Megs of 
source. Lots of educational games. July 1993. 
CICA MS Windows CDROM $29.95* 
2518 files of MS Windows programs. Utilities, 
games, source code, programming tools, fonts, 
drivers, icons. April 1993. 

Simtel MSDOS CDROM $29.95* 

650 Megabytes, 9000+ files.Programming tools, 
utilities, editors, education, source 
code and more. May 1993. 

* Shareware programs 
require separate payment 
to authors if found useful. 

1-800-786-9907 orders@cdrom.com 
FAX 1-510-674-0821 
$5 S&H per order (USA Canada Mexico) 

$10 overseas 1 -510-674-0783 AMEX/VISA/MC/COD 
All our disks are 
unconditionally guaranteed. 

Walnut Creek CDROM 

4041 Pike Lane, Suite D-699 
Concord, CA 94520 
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The Art of Visual Basic Programming ™ 

This amazing new book by J. D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 

ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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Most aspects of this magazine are very much a team effort, 
but in this case, I have to admit that the person who should 
receive credit is me, me, me! On the other hand, I also get credit 
for the fact that wddj.hlp gets updated somewhat irregularly; it 
usually happens when I have a little free time and feel guilty 
about how long it's been since it was last updated. For anyone 
who does not know what we are talking about, download win- 
dex.zip from Library 7 (R8D Publications) in forum CLMFORUM 
on CompuServe. This has a Windows help file that provides a 
cross reference of our back issues. As you point out, we need to 
do a better job of letting people know this exists. 


As for CDROM, this is definitely something in the works at 
R8D. We are already available on Ziff-Davis' "Computer Select," 
but that is somewhat pricey and does not include articles' source 
code (one of the most important features of our magazine). Un¬ 
fortunately, getting past issues onto CDROM turns out to be 
non-trivial for a variety of mundane reasons. I agree with you 
about the importance of a CDROM archive, though, and we will 
certainly let readers know when we have something along 
those lines to offer, -rib 
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BRID GIT™ 

Your Windows & DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll+ and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tei:(602) 991-7272 • Fax:(602) 483-7674 
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GCP++ is the 
development 
solution for 
TCP/IP under 
Windows! 

Encapsulates TCP, UDP, TELNET & TFTP in a 
robust and easy-to-use server, so you start 
with proven socket library code! 

Genisys Comm Pack++ 

• Now includes WINSOCK SDK and VT-220 Custom Control! • 
• OLTP, emulators, DBMS, all client/server apps • 

• VB Custom Control and DLL interlaces • 

Download your GCP++ Evaluation Edition today! 

GENISYS Comm, Inc. 

314 S Jay St, Rome. NY 13440 
315-339-5502 • lax 5528 
GCPt-n@GENISYS.com 
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MOOSOPT- 

WIN1XW5- 

COMPUIBU 



0 Shared DLL resources 
supports multiple applications 
and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled), 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference. 

0 Control panel utility allows 
dynamic DLL configuration. 

0 WINDOWS.TXT compatibilty 
for DOS support. 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr., Atlanta, GA 30350 

ffi TEL/FAX (404) 992-0536 

Also available at the Programmer's Connection! 
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MULTI-PLATFORM CD ROMS 


GRAPHICS 1 CD ROM $24.95 

HUNDREDS of Graphic programs & Utilities w/ source 
& sample data. Animation, drawing & Paint, converters, 
fractals, JPEG, mapping, plotting, ray tracing, etc. Full 
description of all popular graphic file formats. 16,000 
FILES, 426 MB 

AUDIO 1 CD ROM $24.95 

More than 1400 sample sounds & MOD files PLUS 
Hundreds of audio programs and utilities w/ source. 
Converters, editors, generators, players, samplers, 
speech, trackers, etc. 

LANGUAGE / OS CD ROM $39.95 
The LARGEST collection of source & executables for 
compilers, interpreters, function libraries, and 
documentations for standard and research computer 
languages and operating systems ever assembled, > 649 
MB. Includes Ada, Basic, C, C++, E, E++, Forth, Lisp, 
Mach, Modula, Oberon, Pascal, Prolog, Rexx, Scheme, 
Simula, TCL, etc. 

KNOWLEDGE MEDIA Inc. 

434 Nunncky, Suite B, Paradise, CA 95949 USA 
1-800-78 CD ROM - VISA/MC/COD 
+1-916-872-3826 Volce/FAX 
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Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 



Sound & Vision Edition 


A hypertext / hypermedia Help Database Development Kit 
with two royalty free help engines and a help compiler with a 
built in cross reference tool. The current version is 10.0. 


ONE source generates help for MANY target formats like: 
Windows, OS/2, Microsoft Multimedia Viewer, THELP, 
DESQview/X, QuickHelp, PopHelp, word processors, text 
documents with table of contents, glossary and index. 


Write Once Help Many ! 


Supports Topics, PopUps, Links, Keywords, text formats, 
navigational and structural facilities, target code insertion, 
multiple module files, automatic Pascal/C/C++ reference 
generation, exception handling, graphics, sound, groups, 
multiple file target databases, Application Launch, user 
defined link templates, auto exports creation, and more. 

Get a demo version of HLPDK from CompuServe, Internet, 
PsL and other popular catalogs and BBS's. 

Order your copy from I Soft D&Mot PsL today ! 


$50 


+S&H 


ISoftD&M 

P.O.Box 5517, Coralville, IA 52241 
Tel/Fax (319)351-8413 
CompuServe 76350,333 
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Macro 
Language 
"To Go" 


Easily add Netlogic’s full featured 
macro language facility to your 
Windows application -- at a fraction of 
the time and cost of developing it your¬ 
self. Seamless integration. Full basic 
syntax. Integrated editor and debug¬ 
ger. Extendable and modifiable. For 
more information: Netlogic Inc., 915 
Broadway, New York, NY 10010. 
Phone 800-638-0048. Fax 212-533-9524 

Pro Macro ™ 

Your Application’s Shortcut to Power 

□ Request 158 on Reader Service Card □ 


Cport 


Serial Communications for C/C+ + 

✓ Ideal for DOS and embedded applications 

✓ Supports COM1 to COM4 and custom configurations 

✓ Simultaneous serial communications 

✓ Baud rates from 50 to 115200 

✓ Built-in hardware and software handshaking 

✓ Interrupt driven transmitter and receiver 

✓ Optional direct transmit mode 

✓ Adjustable transmit and receive queues 

✓ Queues as large as 65534 bytes 

✓ Supports NS16550 UARTs 

✓ Developed in assembly for optimum speed and size 

✓ Xmodem and Zmodem file transfer 

✓ Source included 

✓ No royalties 


$75 (plusshipping) 


J3ri Productions 
39120 Argonaut Way, Ste 772 
Fremont, CA 94538 
tt 510-794-0616 v 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts 
and save time with 
VFEdit®\ Record, crop, cut, 
copy, paste, mix, fade, echo, 
volume & more with your 
Dialogic™ D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TUF DLL™ our Tel I/F 
Dynamic Link Library. 

3. Audio TooIBox™ 
converts to and from 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 
& 8 at any sample rate! 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
VoxFonts ™, our "software 
only" text-to-speech library! 


Order Now: 1-800-234-VISI 


I Voice Information Systems: 24 N Merion Ave, Bryn Mawr, Pa 19010 I 

Tel: 215 -747-5035/ BBS: 215-747-50 62/ Fax: 1-800-234-FXIT jj 
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I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

Windows/DOS 

□ DEVELOPER'S JOURNAL 


Call 913 - 841-1631 today for 
information about 
advertising opportunities in 
Windows/DOS Developer’s Journal. 

Advanced. Serious. 
Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Christine • Midwest I Edwin - West 
913 - 841-1622 1913 - 841-6733 1913 - 841-1626 


IMWHelp 


Ulindoui/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
□ Request 223 on Reader Service Card □ 



C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION ! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, ’C’ statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL : C-DOC ($199) All 5 programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deterred reports. 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (4161-858-4466 

L5N-4M1 Demos/BBS (1161-858-1916 


see AD INDEX for our larger ad 
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Attention Oracle Developers 


stioci.dll 


This C++ DLL will simplify and 
speed up the development of 
your C++ Windows programs for 
Oracle client/server applications. 

Requires ORACLE OCI interface. 

Enhanced version with highly 
useful debugging methods using 
Protoview interface included at 
no additional cost. 

Many examples provided with 
documentation. Includes source. 
Departmental license with no 
royalties. 

$60 

CJ I nr' 32985 Hamilton Ct. S-l 11 
O I 11 1C Farmington Hills, Ml 48334 
313-488-0357 
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JOBS 

PM 
Mac 
Oracle 
Progress 
Windows NT 
Smalltalk 
Case 
OS/2 

Our midwest Clients are using 
Leading edge technology you thought 
you'd only see on the coasts. Discover the 
heartland, our quality of life and our 
commitment to technology. 

Employer Paid fees only. 

All recruiters are certified by the NAPC. 

Brad Moore, C.P.C. 

256 N. 115th Street, Suite 1. Omaha, NE 68154-2521 
(402) 334-7255 Fax (402) 334-7148 


□ Request 219 on Reader Service Card □ 



OPTUNK 5.0 'SLovs 


Now shrinks program file sizes 
another SO%! 

Enables Windows developers to generate compressed 
self-loading executables (.EXE) and Dynamic Link Librar¬ 
ies (.DLL), thus reducing file sizes an additional 50%. 

Benefits include: 

• Loads applications faster 

• Saves you $’s - fewer 
diskettes to ship 

• Speeds up installation tirr 

• Complicates reverse 
engineering 

• Reduces your customers' 
disk requirements 

• Only requires relinking 
Other reasons to use OPTUNK: 

• Fastest Windows linking • Builds the smallest programs 

• Unrivalled capacity • No limits on debug information 

• Eliminates RC, IMPUB, IMPDEF 

TO ORDER CONTACT: 

SLR Systems, Inc. 

1622 N. Main Street, Butler, PA 16001 USA 
Phone: (412) 282-0864: Fax: (412) 282-796 5 

□ Request 154 on Reader Service Card □ 
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(913) 841-2624. 
Please circle no more than 
30 numbers. 


Use with the February 1994 issue 
only. 

□ Please start my subscription to 
Windows/DOS Developer's Journal 
for one year. Bill me 
$29 (U.S.); $45 (Canada/Mexico); 
or $64 (all other countries). 
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□ YES! Send me 12 issues of Windows/DOS Developer’s Journal for only $29! 

□ 2 years (24 issues) for $54 □ 3 years (36 issues) for $77 

□ Bill Me CH Visa □ MasterCard 
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Please allow up to six weeks for delivery of first issue. Orders outside the US must be prepaid in US funds. CANADA/MEXICO 
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SOFTWARE SECURITY INC 

The Empire State Building 
350 Fifth Avenue, Suite 7204 
New York, NY 10118, USA 2 

Tel: (800) 2234277 J 

212-564 5678 8 

Fax: 212-5643377 g 

International Aladdin 
Office Knowledge Systems Ltd. 

15 Beit Oved St., Tel Aviv, Israel E 

P.O.Box 11141, Tel Aviv 61110 
Tel: 972-3-5375795 
Fax: 972-3-5375796 
AppleLink: ALADDIN.KNOW 


CompuServe: 100274,434 5 

France Aladdin France SA 

Tel: 33 1 40 85 98 85 I 

Fax: 33 141 2190 56 0 


North 

America 


Call now for your 
HASP® evaluation kit. 


In every successful software product 
there is a spark of magic. That magic 
brings together the ingenuity, skill and 
years of hard work you’ve invested 
in developing something unique and 
valuable. 


Trouble is, the worldwide epidemic of 
software piracy threatens your 
investment. By draining potential 
revenues, the illegal use of software 
dramatically reduces your profit margins. 


Aladdin’s business is helping software 
companies protect their products - and 
their profits. 


Since 1984, over 8,000 developers in more 
than 60 countries have chosen HASP - 
the Professional Software Protection 
System - to increase their revenues. 


HASP 1 delivers the highest level of 
security for developers, without 
inconveniencing legitimate users. 
Experts recognize its design as the most 
technologically advanced software 
protection product on the market. 


That’s our 


magic. 


Some Magic Words to Help Software 
Developers Increase Their Revenues 


^’5.; 
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r 

wt 


_ - - 

SEE US AT: 
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IT Forum, Booth K84, Hall 1, Paris France, February 1994 
Software Development, Booth 1131, San Jose CA., March 1994 
CeBIT, Booth B55, Hall 18, Hannover Germany, March 1994 


“Aladdin's HASP gives 
our customers the key 
to protect their investment 
in software development." 


David Asia, CEO of 
Magic Software 
Enterprises Inc., 
a world leader 
in Application 
Generation software. 
Listed by Forbes as one 
of the 50 fastest 
growing companies 
under $500 Million. 


ALADDIN 



member of 



It runs with 

NetWare 



AoBabte and Beatty! 



■ Australia Conlah 3 8985685 ■ Belgium Akkermans 3 2338826 ■ Czech ATLAS 2 766085 ■ Chile Micrologica 2 222 1388 

■ Denmark SC Metric 42 804200 ■ Finland ID-Systems 0 870 3520 ■ Germany CSS 201 7498640 ■ Greece Unibrain 1 6856320 

■ Holland Akkermans 45 241444 ■ Italy Partner Data 2 26147380 ■ Japan Athena, 3 58 213284 ■ Korea Dae-A 2 848 4481 

■ New Zealand Training . 4 5666014 ■ Poland Systherm 6l 475065 ■ Portugal Futurmatica 1 4116269 B South Africa D Le Roux, 11 886 4704 
B Spain PC Hardware, 3 4493193 B Switzerland Opag 6l 7112245 B Taiwan Teco 2-555 9676 B Turkey Mikrobeta 4-4677504 





AVOID EMBARRASSMENT! 



“A customer found a bug in 
our software with a tool 
called BOUNDS-CHECKER .. . 

Why aren’t we using 

BOUNDS-CHECKER?” 


I 


Use BOUNDS-CHECKER ™ V2.0 For Windows, The Automatic Bug Finder! 


Whether you're the boss, the QA Manager or the programmer, it's your responsibility to ensure that 
your company's Windows programs are "bug-free" before they get into the hands of customers, 
If you're developing under C or C++, producing a "bug-free" Windows product is no longer a long 
and stressful experience. 


Announcing BOUNDS-CHECKER V2.0 For 
Windows, the software developer's "safety-net". 

Quickly and easily eliminate the hardest-to-find 
Windows errors that can take days - even weeks 
to find like: 

• API Parameter Errors 

• API Return Value Errors 

• Data and Heap Corruption 

• Resource Leakage Problems 

• Memory Leakage Problems 

• Processor Faults 

HOW IT WORKS - BOUNDS-CHECKER works by 
transparently setting hundreds of breakpoints within 
your program to monitor its behavior. When a bug 
is detected, BOUNDS-CHECKER immediately stops 
your program and pops up showing the problem. 

You can then inspect your program's source, vari¬ 
ables, stack and heap ... with BOUNDS-CHECKER's 
powerful display windows. 

EVENTLOGGING - BOUNDS-CHECKER nowlogs 
all Windows events. Many Windows bugs are diffi¬ 
cult to find because of the event driven, multi-tasking, mes¬ 
sage based nature of Windows. BOUNDS-CHECKER V2.0 For 
Windows introduces an event logging and display capability 
that captures all Windows messages, API calls, API returns 
and other events. The information is displayed in a high-level 
overview that lets you see how your program is interacting 
with Windows. When yob want to see more detail, simply click 
to see a section expanded in great detail. 

EASY TO USE — Unlike other debugging tools, there's no 
learning curve with BOUNDS-CHECKER. Simply select your 
program's name from BOUNDS-CHECKER's menu; all the rest 
is automatic. There is nothing to link-in and no macros to 
compile into your program. All this plus the functionality of a 
heap checker, super spy utility, debug kernel, API debugger, 
and a post mortem tool into a single comprehensive auto¬ 
matic bug finder. 


Eile Action Settings Window Help 



Nu-Mega Technologies Demo 
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BCHKW-DEM03.EXE 
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pPal->palVer*ion 
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BOUNDS-CHECKER Trapping a Parameter Validation Error 



For even greater debugging power get the 
Nu-Mega Power Pack! The Power Pack 
combines BOUNDS-CHECKER and Soft-ICE 
for Dos and Windows all bundled at great 
savings that put you in total control of both 
environments. And to make things even 
better you save over $400 and it comes in 
the great carrying case shown here. 

Call Today 


Call now for overnight delivery. 

BOUNDS-CHECKER V2.0 For Windows... Only $249 
BOUNDS-CHECKER For MS DOS... $199 - >. 

Order both versions & SAVE $150... Only $298 


BOUNDS CHECKER, SOFT-ICE. AND NU-MEGA TECHNOLOGIES are trademarks owned by Nu-Mega Technologies. Inc. All other trademarks are owned by their respective owners. 


Call (603) 889-2386 
fax (603) 889-1135 


P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 
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MONEY-BACK GUARANTEE 


24 HOUR BBS 
603-595-0386 
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